Miko Subscribe & Save documentation
Sell subscriptions and subscribe and save on any product, with a self-serve customer portal, automatic failed-payment recovery and retention tools.
This app is in review with Shopify. These pages are the complete merchant guide; the App Store listing follows on approval.
Getting started
Creating offers
- Creating a subscribe and save offerAn offer is a discount plus one or more delivery frequencies, attached to whole products or to specific variants.
- Choosing delivery frequenciesThe seven frequency presets, how many to put in front of a shopper, and how a subscriber changes theirs later.
- A bigger discount on the first deliveryRun a deeper intro discount on delivery one and your standard discount after it, priced by Shopify on every renewal.
- Prepaid subscriptionsCharge once for several deliveries instead of once per delivery, and when that is the better shape of offer.
On your storefront
- The Subscribe & Save widgetThe theme block that shows your one-time and subscription prices side by side, and everything you can change about it.
- The customer portalWhere subscribers skip, pause, swap, reschedule, change frequency or cancel, on your own domain and in your own colors.
- Subscription links in customer accountsThe customer account blocks that put Manage your subscription in the order list and on the order status page.
Managing subscriptions
- Managing subscribers from the adminEvery subscription on the store in one list, kept in sync by Shopify webhooks and a background reconcile.
- How recurring billing runsWhat the hourly maintenance job does, and why creating each billing attempt is the app's job rather than Shopify's.
- Recovering failed paymentsThe retry ladder, what stops a retry early, how a late card fix still counts as recovered, and SMS recovery.
Retention
- Save offers in the cancel flowThe five kinds of offer a subscriber can be shown instead of cancelling, and which ones you have to fulfill yourself.
- Who is likely to cancelThe churn score and band on each active subscriber, the factors behind it, and what to do with the list.
- Why subscribers cancelClustered cancel reasons and your save rate, and how to read them without discounting away the ones that are fine.
- The AI retention toolsChurn-save, offer optimization, cancel insights, smart dunning and add-on recommendations, and the three rules they all follow.
AI assistants
- Managing subscriptions from AI assistantsLet subscribers skip, pause or swap from ChatGPT, Claude and Copilot, with cancellations held behind a buyer confirmation.
- How a subscriber connects an assistantThe three steps a shopper takes themselves, and exactly what the resulting key can and cannot reach.
- Your offer feed for AI assistantsThe read-only feed and discovery file that let an assistant describe your offers accurately instead of guessing.
Settings and data
- Settings referenceEvery switch in the app, what it changes, and why plan gates are re-checked where a feature is used.
- LanguagesThe languages the admin is available in, and why storefront wording stays yours.
- What data the app usesExactly which Shopify data a subscription app needs, what it never touches, and how deletion works.
Troubleshooting
Start here when something is not behaving the way you expect. Each article below covers one symptom, with the checks in the order that resolves the most cases first.
- The subscribe widget is not showing on a product pageThe block renders nothing on a product with no selling plans, so this is almost always a product that is not attached to an offer yet.
- A new subscription did not appear under SubscribersContracts arrive by webhook within seconds, so a missing one usually means the shopper checked out one-time rather than choosing the subscribe option.
- A recurring payment failedNormal, and the app is built for it. Check dunning is on, where the subscription sits on the 1, 3, 5 and 7 day ladder, and whether the card still exists.
- Save offers are not showing when a subscriber cancelsThree causes: the cancel flow is switched off, every offer is still a draft, or the offer is set to fire for high-risk subscribers only.
- An AI assistant cannot connect, or its requests are refusedStart with the endpoint switch in Settings. After that it is usually an expired key, a reused confirmation link, or a cancel correctly waiting on the buyer.
- Churn scores are missing, or every subscriber looks the sameScores need history and refresh on the hourly pass. An empty at-risk list is a real answer, not a fault.
- A setting is disabled, or a change did not take effectPlan gates are re-checked on the server where a feature is used, so a stored value from a previous plan stops taking effect the moment the plan changes.
- Still stuckWhat to send us so we can read your store's own agent, billing and dunning logs and answer in one reply.