Add to Subscription puts a button on your product pages, labeled "Add to Shipment" by default. Signed-in subscribers click it to add that product to a subscription they already have, so they don't place a separate order or pay for shipping twice.
Availability
The Business Premium plan includes Add to Subscription (Business Premium Annual, if you pay yearly), and so do the plans above it. On any other plan, you can add it for $25/month.
If Enable Add to Subscription Feature is greyed out, the text under it says how to get it: click the plan name to upgrade, or click Contact us to add the feature to your current plan. If the text says Contact us to turn it on, click Contact us and our support team will help.
Before you start
The Appstle Subscriptions app embed is on in your theme (Online Store → Themes → Customize → App embeds).
Your product page has the Add to Subscription container. Without it, no button shows, even when the feature is on. See Add the container to your theme below.
To try it yourself, you need a customer account with an active subscription.
Add the container to your theme
The button appears inside a small container that you place on your product page. Our support team can add it for you: open the chat in Appstle and ask for the Add to Subscription container. To add it yourself:
In Shopify admin, go to Online Store → Themes and click Customize on your live theme.
Open the Default product template, or the template your products use.
Add a Custom Liquid block where you want the button to appear. Under the Add to cart button works well.
Paste this code into the block:
<div appstle-add-to-shipment-selector></div>Click Save.
Turn on Add to Subscription
In Appstle, go to Subscription Widget and select the Add to Subscription tab. You can also go to More and select Add to existing subscription.
Select Enable Add to Subscription Feature.
Select any other options you want. The table below explains each one.
Click Save.
The options on the Add to Subscription Feature card.
Here is what each option on the card does.
Setting | What it does |
Enable Add to Subscription Feature | Turns the button on for your store. |
Display Add to Subscription Button for Not Logged In User | Shows a greyed-out button to shoppers who aren't signed in, with a tooltip that asks them to sign in. Without this setting, signed-out shoppers see no button. |
Show add to subcription button only on subscription product | Shows the button only on products that have a subscription plan. |
Allow to auto add product | When a customer has exactly one active subscription, the popup adds the product to it right away, with no choice to make. This works only when Show Purchase Options is set to Subscription or One Time Purchase, not Both. For now, use it with Subscription only (see the warning under Change the labels). |
What customers see
What a customer sees depends on whether they are signed in and which subscriptions they have.
Customer | What they see |
Not signed in | A greyed-out button with a tooltip, if you turned on Display Add to Subscription Button for Not Logged In User. Otherwise, no button. |
Signed in, no active subscription | No button. Paused and cancelled subscriptions don't count. |
Signed in, at least one active subscription | The button. |
For a signed-in subscriber, the button shows where you placed the container.
The button, labeled "Add to Shipment" by default, under Add to cart.
When a customer clicks the button, a popup shows their subscriptions with the next order date, how often each renews and what it contains. Each active subscription has a drop-down and a button. The customer picks an option and clicks the button on the subscription they want:
Add to Subscription adds the product to every future order.
One Time Purchase adds it to the next order only.
Which options appear depends on Show Purchase Options. Subscriptions that aren't active are listed too, without a drop-down or a button.
A subscription in the popup, with its drop-down and button.
Change the labels
Below the Add to Subscription Feature card, two sections hold the text that customers see.
Add to Subscription Labels controls the button on the product page. If your store has more than one language, choose the language in the top right first. Then edit:
Add to existing subscription button text. The default is "Add to Shipment".
Add to existing subscription tooltip text. This is the message on the greyed-out button.
Add to existing subscription processing text, success text and error text. Customers don't see these three, because the button always opens the popup, which shows its own messages.
Labels (Customer Portal) controls the popup:
Add To Subscription Title names the recurring choice and its button. The default is "Add to Subscription".
Add to Subscription product added success message shows after the product is added.
Show Purchase Options sets what customers can choose: Both, Subscription or One Time Purchase.
Add to order Label text is the add button in your customer portal, not in this popup.
Don't set Show Purchase Options to One Time Purchase on its own for now. With that choice, the product is added to every future order, not only the next one. This includes adds made by Allow to auto add product. To offer one-time adds, choose Both.
Things to know
The button works on product pages. It isn't available on your home page or collection pages by default. Contact our support team if you want it there.
The button adds the variant the customer has selected on the product page.
It always adds one unit, whatever quantity the customer chose on the product page.
The price of the added product follows Discount policy for added products in Customer Portal → Customize portal → Settings → Discounts on added products.
Add to Subscription follows your customer portal's rules for adding products, such as which products customers can add. If customers see an error, see the FAQ below.
The One Time Purchase option is greyed out unless Customers can add one-time products is on in Customer Portal → Customize portal → Features → One-time products. If your Customer Portal page has a Configuration tab and no Customize portal button, turn on Let customers add one-time purchases to their subscription orders in its One-time Product section instead.
FAQs
Why don't I see the button on my product page?
Check these, in order:
Enable Add to Subscription Feature is selected and saved. If it's greyed out, see Availability above.
The Appstle Subscriptions app embed is on in your theme.
The container code is on the product template of your live theme.
You're testing while signed in to your store as a customer with at least one active subscription. Being signed in to Shopify admin isn't enough.
If Show add to subcription button only on subscription product is on, the product has a subscription plan.
The product is available to buy.
Why is the button greyed out?
The shopper isn't signed in. Ask them to sign in to their account, then reload the page.
Why does the customer see an error when they add the product?
Add to Subscription uses your customer portal's rules for adding products. In Customer Portal → Customize portal, check that:
Features → Products → Customers can add products to a subscription is on. For one-time adds, Features → One-time products → Customers can add one-time products is on too.
Settings → Product restrictions → Which products customers can add to subscriptions includes this product.
Settings → Products → Minimum quantity when adding or changing products is empty or 1. The button always adds one unit.
Settings → Timing limits → Product changes allows changes today.
If your Customer Portal page has a Configuration tab and no Customize portal button, check the same settings on that tab.
How do I change "Add to Shipment" to something else?
Edit Add to existing subscription button text in the Add to Subscription Labels section.
Need help?
Contact our support team from the chat in the Appstle app, and tell us your store URL and the product page where the button should show.



