If shoppers don't see the subscription options on a product page, work through the checks below in order. Most problems are found at Check 1 or Check 2. The whole list takes about 10 minutes.
Everything starts on the widget page: Apps → RecurX Subscriptions → Subscriptions → Widget → Customize widget. RecurX checks your published theme and your plans there and shows what it finds at the top of the page.
Step 1: Read the status card
Look at the Widget on your store card:
| Status | What it means |
|---|---|
| Active | The RecurX app embed is on in your published theme. Go on to Step 3. |
| Not active | The app embed is off. Go to Step 2. |
| Reinstall required | RecurX needs updated permissions. Reinstall the app to grant them. Click Reinstall app. |
| Checking | RecurX is still reading your theme. Wait a moment. |
If you've just changed something in the theme editor, click Check again to refresh the status.
Step 2: Turn on the app embed
If the card says Not active:
- Click Open theme editor. The theme editor opens with the RecurX app embed selected.
- Switch on RecurX Subscriptions.
- Click Save in the theme editor.
- Back in RecurX, click Check again.
Note: The warning states in this guide are shown with example data. On your store you only see the one that applies.
Screenshots of the theme editor are in Install and customize the subscription widget.
Important: RecurX checks your published theme. Turning the embed on in a draft theme doesn't change your live store until you publish that theme.
Step 3: Check the banners above the status card
When the embed is on but the widget has nothing to show, a yellow banner explains why.
"Nothing shows on your store yet" — one of:
- The widget is on, but you have no subscription plans yet. Create one in Plans.
- The widget is on, but none of your plans has a product yet. Add a product to a plan.
"Your plan's products aren't on your Online Store" — shoppers can't open these products, so the subscribe option can't appear on them. In Shopify, open each product listed in the banner, include Online Store under Sales channels and make sure its status is Active. Or add products that are already on your Online Store to your plan.
Step 4: Make sure the product is in an active plan
The widget only appears on products that belong to an active plan.
- Go to Subscriptions → Plans and open the plan.
- In the Products card, check that the product (or its collection) is listed. If not, click Select products, add it, and save the plan.
- In the Status card on the right, check that the plan is Active. Inactive plans are hidden from your storefront.
Tip: Changed the plan in Shopify, or not sure it reached Shopify? Open it in RecurX and save it again — saving republishes the plan to Shopify (Publishing to Shopify…).
Step 5: Give the widget a place on the page
On most themes RecurX places itself next to the Add to cart button automatically. Some themes don't leave room. When that happens on your store, the status card says Your storefront loaded RecurX but your theme didn't leave anywhere to put the widget, so shoppers aren't seeing subscription options.
Click Add it to my product page. Your theme editor opens with the RecurX block already added to your product template — just press Save. You can drag the block to where it should appear, usually just above the Add to cart button.
Note: The widget shows on product pages. To offer a subscription on other pages (home page featured product, page builders), use the Product card subscribe block — see Storefront widgets overview.
Step 6: Check sold-out products
On the Pro plan, Show the widget on sold-out products (widget page, Content tab, When the widget shows and what can be added) decides what happens when every variant is sold out:
- On (default): shoppers see a disabled Sold out button and can ask to be told when it's back.
- Off: no widget when every variant is sold out.
Step 7: Look again without cached pages
Your browser or theme can show an old copy of the page.
- Open the product page in a private (incognito) window, or hard-reload it (Cmd + Shift + R on Mac, Ctrl + Shift + R on Windows).
- If your store is password-protected, enter the storefront password first.
- Make sure you're looking at a product from Step 4.
Still not showing?
Open Help at the top of any RecurX page and choose Contact support. Tell us the product URL, your theme name and what the Widget on your store card says — that's usually enough to find the cause quickly.