> For the complete documentation index, see [llms.txt](https://subscriptionsuite.gitbook.io/helpdoc/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://subscriptionsuite.gitbook.io/helpdoc/getting-started/frequently-asked-questions.md). # Frequently Asked Questions Here are some of the most common questions about SubscriptionSuite. ### Getting Started #### 1. What is SubscriptionSuite? SubscriptionSuite is a Shopify app that helps you sell and manage subscriptions. You can create subscription plans, offer prepaid subscriptions, build custom subscription boxes, manage subscribers, recover failed payments, track analytics, and more. #### 2. How do I start selling subscriptions? Install SubscriptionSuite and complete the onboarding setup. The onboarding will help you enable the app embed and create your first subscription plan. You can also set everything up manually from the SubscriptionSuite dashboard. #### 3. Do I need to enable the SubscriptionSuite App Embed? Yes. The App Embed needs to be enabled for the SubscriptionSuite storefront features to work correctly. Go to: **Online Store → Themes → Customize → App embeds → SubscriptionSuite** Then turn it on. #### 4. Can I add the subscription widget to a product page? Yes. You can add the SubscriptionSuite subscription widget using the Shopify theme editor and the SubscriptionSuite app block. *** ## Subscription Plans #### 5. What is a subscription plan? A subscription plan defines how a customer is charged and how often they receive the product. For example: **Every week** **Every month** **Every 3 months** You can also add discounts, trials, prepaid options, and other settings depending on your plan configuration. #### 6. Can I offer a free trial? Yes. You can add a trial period to a subscription plan. For example, you could offer: **7 day free trial** The customer subscribes and the first charge happens after the trial period. #### 7. Can I offer a prepaid subscription? Yes. A prepaid subscription allows the customer to pay for multiple deliveries upfront instead of being charged separately for every delivery. For example, a customer could pay upfront for a 3 month subscription. #### 8. Can I offer both regular and prepaid subscriptions? Yes. You can create different plans for the same product and let customers choose the option that works best for them. #### 9. Can I offer different delivery frequencies? Yes. You can create different frequencies such as every week, every 2 weeks, every month, or other supported intervals. #### 10. Can I give customers a discount for subscribing? Yes. Subscription plans can include discounts so customers can pay less than the one time price when they subscribe. *** ## Build a Box #### 11. What is Build a Box? Build a Box lets customers create their own subscription box from a set of products selected by the merchant. The merchant decides which products are available and how many products customers can choose. #### 12. Can I set a minimum and maximum number of products? Yes. You can set the minimum and maximum number of products a customer can select. For example: **Choose at least 3 products** **Choose up to 6 products** You can also preselect products for the customer. #### 13. Can I customize how my Build a Box looks? Yes. Build a Box includes a storefront customizer where you can customize the layout, colors, copy, product cards, and other parts of the box experience. #### 14. Is Build a Box a Shopify product? No. Build a Box is not a virtual Shopify product. It creates a dedicated storefront experience that customers access through a link. You can add this link to your main menu, product pages, or anywhere else you want customers to find it. *** ## Customer Portal #### 17. What can customers do from the Customer Portal? Depending on what you enable, customers can manage their subscriptions themselves. They can be allowed to: * Pause and resume * Skip a delivery * Change delivery frequency * Swap products * Add one time items * Change their shipping address * Cancel their subscription #### 18. Can I choose which customer actions are available? Yes. Customer self service actions can be enabled or disabled individually from the settings. This lets you decide how much control customers have over their subscriptions. *** ## Billing & Failed Payments #### 19. What happens when a subscription payment fails? SubscriptionSuite uses your configured **Dunning** rules to decide what happens after a failed payment. You can control what action should happen after each failed attempt and how long SubscriptionSuite should wait before trying again. #### 20. Can I customize the Dunning process? Yes. The Dunning system is customizable. You can decide: **What happens after a failure** **How long to wait before the next attempt** **What happens after the next failure** This gives you control over your entire payment recovery process. #### 21. What happens if a payment keeps failing? The subscription continues through the Dunning rules you have configured. Once the configured recovery attempts or actions are completed, SubscriptionSuite can take the final action you've configured. *** ## Inventory Protection #### 22. What is the 72 hour inventory check? SubscriptionSuite checks inventory before an upcoming subscription renewal so you can identify potential stock problems before the order is processed. The default check is: **3 days before renewal** **90% inventory threshold** You can change both settings. #### 23. Can I change the 72 hour inventory setting? Yes. The default is **3 days and 90%**, but you can customize the prediction window and inventory threshold based on your store's needs. #### 24. What happens when inventory is low? SubscriptionSuite flags the upcoming renewal so the merchant has time to take action before the subscription order is processed. *** ## Analytics #### 25. What can I see in SubscriptionSuite Analytics? Analytics gives you an overview of your subscription business, including metrics such as: * MRR * Active subscriptions * New subscriptions * Revenue * AOV * Cancellations * Failed charges You can also view trends and retention information. #### 26. Can I filter my subscription analytics? Yes. You can change the date range and other available filters to look at different periods and compare your subscription performance. *** ## Integrations #### 27. Can I connect SubscriptionSuite to Klaviyo, Omnisend, or Drip? Yes. SubscriptionSuite supports integrations with **Klaviyo, Omnisend, and Drip**. Subscription events such as subscription creation, cancellation, pauses, skips, product swaps, upcoming orders, and payment failures can be sent to these platforms. #### 28. Will customers receive duplicate emails when I connect an email platform? No. When you connect Klaviyo, Omnisend, or Drip, SubscriptionSuite automatically suppresses overlapping built in email alerts. If you disconnect the integration, SubscriptionSuite's built in email system automatically becomes active again. #### 29. Can I test subscription events before real customers trigger them? Yes. Klaviyo, Omnisend, and Drip all have tools for sending test or seeded events so you can set up and test your automations before real subscription activity comes in. #### 30. Can I use Shopify Flow with SubscriptionSuite? Yes. You can use subscription activity to create Shopify Flow automations and perform actions automatically based on subscription events. *** ## Storefront JS API #### 31. What is the Storefront JS API? The Storefront JS API allows developers to access SubscriptionSuite subscription information from their Shopify theme using JavaScript. It can read plans, prices, subscription selections, and subscription events. #### 32. Does the Storefront JS API require an API key? No. It does not require an API key, npm package, or build step. However, **Storefront JS API access must be approved** before real subscription plans are returned. #### 33. Can the Storefront JS API modify subscriptions? No. The API is read only. It cannot directly pause, skip, cancel, or change a subscription. #### 34. Why does the Storefront JS API return no plans? First check that: * Storefront JS API access has been approved * The SubscriptionSuite App Embed is enabled * The product has an active subscription plan * You are using a supported page If access has not been approved, the API intentionally returns an empty plan list. *** ### Migration #### 35. Can I migrate existing subscriptions to SubscriptionSuite? Yes. SubscriptionSuite includes migration tools for bringing subscriptions from supported sources into the app. You can select the available source and follow the migration steps provided in the Migration section. #### 36. Can I import subscriptions using CSV? Yes. You can use the **Other CSV** option to bring subscription data into SubscriptionSuite using the supported Shopify or Recharge CSV format. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://subscriptionsuite.gitbook.io/helpdoc/getting-started/frequently-asked-questions.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.