Update a subscription
Update aspects of a subscription, such as products, quantities, and coupons.
Overview
Navigate to the ‘Update Subscription’ interface from any subscription
![](https://mintlify.s3-us-west-1.amazonaws.com/hyperline/images/subscriptions/update/1.png)
You will find several options allowing you to adjust many aspects of the subscription:
![](https://mintlify.s3-us-west-1.amazonaws.com/hyperline/images/subscriptions/update/2.png)
Configuration
![](https://mintlify.s3-us-west-1.amazonaws.com/hyperline/images/subscriptions/update/5.png)
Invoicing options
Update products on the subscription
You can update the products that have been added to your subscription as well as remove them and add new ones
![](https://mintlify.s3-us-west-1.amazonaws.com/hyperline/images/subscriptions/update/4.png)
Updating a fee product
![](https://mintlify.s3-us-west-1.amazonaws.com/hyperline/images/subscriptions/update/3.png)
Updating a usage-based product
![](https://mintlify.s3-us-west-1.amazonaws.com/hyperline/images/subscriptions/update/add-product.png)
Adding a new product
Add a product to a subscription
You can add a product to a subscription at any time. The product will be added to the subscription and the customer will be charged according to the options you choose.
On the subscription, click on Add product
![](https://mintlify.s3-us-west-1.amazonaws.com/hyperline/images/subscriptions/add-product/button-highlight.png)
Choose the product you want to add and edit it
![](https://mintlify.s3-us-west-1.amazonaws.com/hyperline/images/subscriptions/add-product/highlight-edit-product-1.png)
![](https://mintlify.s3-us-west-1.amazonaws.com/hyperline/images/subscriptions/add-product/highlight-edit-product-2.png)
In this step, you can override anything on the product such as it’s price or name.
Just like when assigning a subscription, these changes are limited to this subscription and won’t affect existing products in your catalogue.
Choose the payment options for adding the product
![](https://mintlify.s3-us-west-1.amazonaws.com/hyperline/images/subscriptions/add-product/highlight-preview.png)
- Do not charge: Adds the product to the subscription without charging your customer.
- Charge pro-rata: Charges your customer a pro-rata amount based on the remaining time in the billing period.
- Charge full price: Charges the full price of the product to your customer immediately.
You will see a small recap of the options you chose. on the same page.
Click on Add product to confirm your selection.
Remove a product from a subscription
You can do so at any time. The product will be removed from the subscription and the customer will be refunded according to the options you choose.
On the subscription details page, click on the product you want to remove, then click on the remove button at the bottom
![](https://mintlify.s3-us-west-1.amazonaws.com/hyperline/images/subscriptions/remove-product/button-highlight.png)
Choose the payment options for removing the product
![](https://mintlify.s3-us-west-1.amazonaws.com/hyperline/images/subscriptions/remove-product/highlight-preview.png)
- Do not refund: Removes the product from the subscription without issuing a refund to your customer.
- Refund pro-rata Refunds your customer a pro-rata amount based on the remaining time in the billing period.
- Refund full price Refunds the full price of the product to your customer immediately.
You will see a small recap of the options you chose. on the same page.
Click on Remove product to confirm your selection.
When removing a product before billing, for instance, if the product is on a monthly billing, charged “end of period”, and the removal is initiated mid-month you’ll have the option to charge the customer instead. The selection choices will stay consistent.
Update product quantities
Quantities can be updated for any products that aren’t directly connected to a data source
![](https://mintlify.s3-us-west-1.amazonaws.com/hyperline/images/subscriptions/update/update-quantity-1.png)
Updating a product quantity
![](https://mintlify.s3-us-west-1.amazonaws.com/hyperline/images/subscriptions/update/update-quantity-2.png)
The same timing and charging options are available
Update product prices
You can update the price of a product on a subscription at any time.
![](https://mintlify.s3-us-west-1.amazonaws.com/hyperline/images/subscriptions/update/update-price-1.png)
Updating a product price
![](https://mintlify.s3-us-west-1.amazonaws.com/hyperline/images/subscriptions/update/update-price-2.png)
Updating a fee item price
![](https://mintlify.s3-us-west-1.amazonaws.com/hyperline/images/subscriptions/update/update-price-3.png)
Complex tiered prices can also be updated
Applying and removing coupons
![](https://mintlify.s3-us-west-1.amazonaws.com/hyperline/images/subscriptions/update/add-coupon.png)
Applying a coupon
![](https://mintlify.s3-us-west-1.amazonaws.com/hyperline/images/subscriptions/update/remove-coupon.png)
Removing a coupon