For the complete documentation index, see llms.txt. This page is also available as Markdown.

Changing the products on a subscription contract

Add, edit and remove the products a subscription bills for, and how that differs from changing a single upcoming order.

A contract's products are what it bills for every cycle. Change them here and every future order follows.

To change one delivery without changing the recurring order, see Adjusting an upcoming subscription order instead.

Where the products live

Open the contract from Subscriptions. The first card carries the subscription itself:

  • The cadence and status at the top, for example Deliver every 3 days with an Active pill

  • Next billing date and Date subscribed

  • Products, the line items the contract bills for

  • Subtotal, Shipping and Total

Each product line shows its original price struck through with the subscription price beneath it, so you can see what the customer is actually charged after their plan discount.

Three buttons sit under the totals: Edit shipping rate, Add Free Shipping and Add Product.

Add a product

Click Add Product under the totals.

The picker offers the products available on the plan that matches the contract's current products, so you cannot add something the customer's plan does not support.

The product joins the contract and ships on every future order at the contract's usual cadence.

Edit or remove a product

Each product line has a ••• menu holding Edit and Remove.

Edit opens Edit subscription product, which states at the top: This will update the product for ALL future orders in this subscription. You can change:

  • Select Product / Variant

  • Quantity

Click Update subscription to apply it. Changing the variant here is how you make a permanent swap for the customer.

Remove takes the product off the contract entirely.

Both apply from the next order onward. Orders already created are not rewritten.

Make sure you are on the contract, not an order

The Orders list further down the page has its own ••• menus with Edit and Remove. They look identical to the ones on the Products card, but they change a single delivery rather than the contract.

The modal heading and banner tell you which one you opened:

Modal
Banner
Changes

Edit subscription product

This will update the product for ALL future orders in this subscription.

The contract

Edit upcoming order product

This will update the product ONLY for this upcoming order. The subscription itself will remain unchanged.

One delivery

If you find yourself in Edit upcoming order product and you meant to change the subscription, cancel and use the Products card instead. For everything scoped to a single delivery, see Adjusting an upcoming subscription order.

What the customer can do

Customers can add and remove subscription products themselves from their account dashboard, and swap between the products on their plan. If a contract has changed and you did not do it, the contract's Timeline records who made each change.

Last updated