# Subscription Ramps

## Introduction
Subscription Ramps let you schedule future [subscription](/content/docs/billing/2.0/subscriptions/subscriptions/index.html) pricing changes. This feature supports strategies such as attracting new customers with initial low prices that gradually increase, applying automatic seasonal discounts, and incrementally adding new services. Key features include the scheduled modification of plans, addons, and charges, as well as the application or removal of discounts. Subscription Ramps empower effective pricing management, helping you balance customer acquisition and revenue growth, and adapt efficiently to market demands.

## Key Features
Some key scenarios addressed by Subscription Ramps are:

**Attracting new customers**  
Offer a lower initial cost to encourage new customer sign-ups, then gradually increase pricing automatically as they grow more engaged with your service. This approach helps in acquiring new customers with minimal resistance while maximizing long-term revenue.

**Seasonal discounts**  
Automatically apply discounts or coupons during peak seasons or holidays to capitalize on increased demand.

**Phased service adoption**  
Automatically add new items to a subscription over time, allowing for smooth and controlled adoption of your service offerings by customers.

Subscription Ramps let you schedule the following changes to a subscription:
- Changing the [plan](/content/docs/billing/2.0/product-catalog/plans/index.html).
- Adding, removing, or updating [addons](/content/docs/billing/2.0/product-catalog/addons/index.html) and [charges](/content/docs/billing/2.0/product-catalog/charges/index.html).
- Applying or removing [discounts](/content/docs/billing/2.0/subscriptions/subscription-manual-discounts/index.html) and [coupons](/content/docs/billing/2.0/product-catalog/coupons/index.html).
- Adjusting prices for plans, addons, and charges.

## Limitations  
- The initial release of Subscription Ramps focuses on core functionalities. While it does not include support for [estimates](https://apidocs.chargebee.com/docs/api/estimates), this feature is planned for enhancement in our future updates.
- For subscriptions with [Non-Renewing status](/content/docs/billing/2.0/subscriptions/subscriptions#subscription-status/index.html), the frequency of the Ramp cannot be changed.
- Support for Subscription Ramps with [RevRec](/content/docs/revrec/getting-started-with-revrec/about-revrec/index.html) will be introduced in upcoming quarters.
- Support for Subscription Ramps in Revenue Story will be introduced in upcoming quarters. This is a temporary limitation. For instance, metrics like committed MRR (CMRR) or any revenue projections done by Chargebee Revenue Story, will not have the effect of Subscription Ramps today.
- For advance invoicing and advance invoicing schedules, ramps are applied if they already exist for the subscription. However, advance invoicing isn’t supported when the subscription has mid-term ramps, meaning the ramp effective dates do not match the subscription’s billing cycle dates.

### Create Subscription Ramps  
**Caution**  
After creating ramps in the final step of this section, further edits are not possible. To make changes, [delete](/content/docs/billing/2.0/subscriptions/ramps#delete-subscription-ramps/index.html) and recreate the ramps.

### Prerequisites  
Before creating a ramp on a subscription, make sure:
- The Subscription Ramps [feature is enabled](https://app.chargebee.com/login?forward=https://app.chargebee.com/request_access/subscription-ramps&ref=feature).
- The subscription status is neither **Paused** nor **Canceled**.
- There are no [advance invoices](/content/docs/billing/2.0/invoices-credit-notes-and-quotes/advance-invoices/index.html) or [advance invoicing schedules](/content/docs/billing/2.0/invoices-credit-notes-and-quotes/advance-invoices#setting-up-an-advance-invoicing-schedule/index.html) on the subscription.
- There are no upcoming ramps for the subscription.
- There are fewer than 100 total number of ramps on the subscription.

### Steps to Create Subscription Ramps  
To create subscription ramps, follow these steps:

1. Go to **Subscriptions** on the left navigation.
2. Locate the subscription using [filters](/content/docs/billing/2.0/site-configuration/advanced-filter-options/index.html), if needed.
3. Click the subscription to open its detail page.
4. On the right pane, click **Create Ramps**.
5. Under **When do you want this ramp to begin?**, set the date and time when the ramp should start. The products and prices listed below change as applicable, based on the date and time selected.
6. Under **Product and Pricing**, make the necessary changes:
    1. Change the plan.
    2. Add, remove, or modify recurring addons.
    3. Add or remove coupons or coupon codes.
    4. Add or remove manual discounts.
7. Click **Add** to finalize the ramp. The ramp details collapse into a smaller card.
8. Optional: To add more ramps, click **Add Ramp** and repeat the steps.
9. To remove a draft ramp you have defined above:
    1. Click the ramp's card.
    2. Click **Remove Ramp**.
    3. Click **Confirm**. The ramp is removed only if removing it does not [conflict](/content/docs/billing/2.0/subscriptions/ramps#restrictions-on-deleting-subscription-ramps/index.html) with future ramps on the subscription.
10. To edit a draft ramp you have defined above:
    1. Click the ramp's card.
    2. Click **Edit Ramp**.
11. Click **Create Ramps** to save and schedule the ramps. View them under the **Ramps** section on the subscription detail page.

### View Subscription Ramps  
To view ramps on a subscription, follow these steps:
1. Go to **Subscriptions** on the left navigation.
2. Locate the subscription using [filters](/content/docs/billing/2.0/site-configuration/advanced-filter-options/index.html), if needed.
3. Click the subscription under **Subscription info** to go to its details.
4. Select **Manage Ramps** in the right pane, or scroll to the **Ramps** section and click **View Changes** to see all ramps. They are displayed in chronological order, showing effective dates in the middle pane. The right pane displays the plan, addons, charges, coupons, and discounts on the subscription after ramp execution.

### Edit Subscription  
The Edit Subscription option can be accessed from one of the following places:
- Self serve Portal
- Chargebee site
  - Under customer profile
  - On the subscription details page, on the Actions pane
  - On the subscriptions index page, in the Actions drop-down

It allows you to change one or more of the following aspects of the subscription such as:
- the plan subscribed to
- the price of the plan
- addons attached to the plan (Note: Mandatory addons linked with the subscription aren't automatically removed when changing plans. You must [remove them explicitly](/content/docs/billing/2.0/subscriptions/subscriptions#creating-subscriptions-for-plans-without-trial-period/index.html).)
- plan/addon quantities
- coupons or [coupon codes](/content/docs/billing/2.0/product-catalog/coupon_codes/index.html)
- [number of plan billing cycles](/content/docs/billing/2.0/product-catalog/plans#configuring-product-catalog-settings/index.html)
- [PO Number](/content/docs/billing/2.0/invoices-credit-notes-and-quotes/po-number/index.html)

### Find Subscriptions with Ramps  
You can use [advanced filters](/content/docs/billing/2.0/site-configuration/advanced-filter-options#advanced-filter/index.html) to quickly access subscriptions with ramps. To find and view subscriptions with ramps, follow these steps:
1. Click **Subscriptions** on the left navigation.
2. Click **Filter list** and select attributes for filter. Select **Subscription Ramp** and **Status** as _Scheduled_.
3. Click **Apply Filter**.

### Delete Subscription Ramps  
### Restrictions on Deleting Subscription Ramps  
Chargebee does not allow deleting a subscription ramp when:
- The plan, addons, or charges it **adds** are scheduled for update or removal in a subsequent ramp.
- Any added coupons or discounts are scheduled for removal in a subsequent ramp.

### Steps to Delete Subscription Ramps  
To delete subscription ramps, follow these steps:
1. Go to **Subscriptions** on the left navigation.
2. Locate the subscription using [filters](/content/docs/billing/2.0/site-configuration/advanced-filter-options/index.html), if needed.
3. Click the subscription under **Subscription info** to go to its details.
4. Click **Manage Ramps** on the right pane. Alternatively, scroll down to the **Ramps** section and click **View changes**.
5. Click the **Delete Ramps** button. A modal appears listing the upcoming ramps on the subscription.
6. Select the ramps to delete.
7. Click **Confirm** to permanently delete the selected ramps.

See also

- [Retrieve a subscription ramp API](https://apidocs.chargebee.com/docs/api/ramps/retrieve-a-ramp)
- [List subscription ramps API](https://apidocs.chargebee.com/docs/api/ramps/list-ramps)