Troubleshooting widget issues
While we've designed the Loop widget installation process to be as seamless as possible, there can be instances where the widget may not appear or function as expected. This article will walk you through the most common reasons why the subscription widget might not show up on your product page and how to resolve them. We'll also highlight important prerequisites, theme compatibility checks, and tips for verifying correct setup to ensure your subscription experience goes live without issues.
Prerequisites
General checks
Product and selling plan checks
Preference and edge cases check
Related articles
Need help?
Before we dive into troubleshooting, it's important to ensure the following prerequisites are in place to avoid any setup-related issues.
Check for Shopify theme 2.0: Ensure your store is built on a Shopify 2.0 theme, as only these support app block-based integrations. You can verify this by navigating to Online Store > Themes > Customize — if you see App Blocks available in the theme editor, you're on 2.0. If not, consider upgrading your theme or switching to a compatible one to use Loop widgets without manual coding.
Product page compatibility: Confirm that the product page template and its main section support Shopify app blocks so that the Loop widget can be added seamlessly.
Widget enabled on the store: In the Loop app, verify that the widget is created and its status is set to “Enabled” to ensure it renders on the storefront.
This section covers the basic checks you should perform when facing issues with the widget not appearing or functioning properly on your storefront.
Loop store-front widgets master switch
Ensure that the master switch present in the banner is enabled for all the widgets configured on your store.
Specific widget mapped to product page is active
The widget mapped to the product page should be set to Active in Loop to ensure it appears on the storefront.
Widget mapped to correct theme and product page template
The active widget should be enabled on the correct theme, and within that, mapped to the appropriate product template.
The Loop subscription widget app block is present in the product template
The widget app block should be present in the active state within the product template and must not be hidden or deleted.
This section covers the basic checks at the product and selling plans level.
Product is active and available on the online store and in markets being tested
This is a basic check — the product should not be in draft state, must be available on the online store, and you should also verify the market in which the product is being sold.
Product is mapped to atleast one selling plan
We need to ensure that the product is mapped to a selling plan, and this should be verified in both Loop and Shopify.
Product is mapped to the concerned product template
We need to make sure that the product is correctly mapped to the product template where the widget is hosted.
Selling plan mapped is available on storefront touchpoints
We need to make sure that at least one selling plan to which the product is mapped is set to available on the storefront.
This section covers the preference-based checks.
Hide widget if only one selling plan (for subscription-only products)
If we have set the product to be sold as subscription-only and mapped it to only one selling plan, and if the setting "Hide the subscription widget if only one selling plan is available" is enabled in the widget preferences, then the widget will not be shown.
Hide bundle selling plan preference for single-mapped bundle plans
If we have a product mapped to a single selling plan and it is also being sold as a bundle with that selling plan, and if the setting "Hide bundle selling plans on individual product pages" is enabled in the bundle preferences, then the widget will not be shown on that product page.
Product mapped to the same name, having 2 different selling plans.
In this scenario, if two selling plans have the exact same name and one of them is hidden from the storefront, then the widget will not be shown on the store.
Note: Shopify groups selling plans on the storefront based on their names. Hence, Shopify will consider only one selling plan as mapped.
Selling plan 1: Subscribe and Save
Selling plan 2: Subscribe and Save
Marked as hidden from the storefront
We can see the widget is hidden in this case
Tip: We recommend using different names in such scenario, for example- Subscribe and Save ----- Subscribe & Save
The merchant has done custom code to hide the widget in specific markets/countries.
If this is the case, then the widget will not be visible for those specific markets/countries.
Here are some related articles that may offer additional insight and context.
How to set up Loop widget
Troubleshooting widget issues
Learn about selling plans
No worries — we're here for you!
If you have any questions or need assistance, feel free to email us at support@loopwork.co or chat with us using the support beacon at the bottom right of your screen.
Regards,
Loop Subscriptions Team 🙂
Return to top
In this article
Prerequisites
General checks
Product and selling plan checks
Preference and edge cases check
Related articles
Need help?
Prerequisites
Before we dive into troubleshooting, it's important to ensure the following prerequisites are in place to avoid any setup-related issues.
Check for Shopify theme 2.0: Ensure your store is built on a Shopify 2.0 theme, as only these support app block-based integrations. You can verify this by navigating to Online Store > Themes > Customize — if you see App Blocks available in the theme editor, you're on 2.0. If not, consider upgrading your theme or switching to a compatible one to use Loop widgets without manual coding.
Product page compatibility: Confirm that the product page template and its main section support Shopify app blocks so that the Loop widget can be added seamlessly.
Widget enabled on the store: In the Loop app, verify that the widget is created and its status is set to “Enabled” to ensure it renders on the storefront.
General checks
This section covers the basic checks you should perform when facing issues with the widget not appearing or functioning properly on your storefront.
Loop store-front widgets master switch
Ensure that the master switch present in the banner is enabled for all the widgets configured on your store.
Specific widget mapped to product page is active
The widget mapped to the product page should be set to Active in Loop to ensure it appears on the storefront.
Widget mapped to correct theme and product page template
The active widget should be enabled on the correct theme, and within that, mapped to the appropriate product template.
The Loop subscription widget app block is present in the product template
The widget app block should be present in the active state within the product template and must not be hidden or deleted.
Product and selling plan checks
This section covers the basic checks at the product and selling plans level.
Product is active and available on the online store and in markets being tested
This is a basic check — the product should not be in draft state, must be available on the online store, and you should also verify the market in which the product is being sold.
Product is mapped to atleast one selling plan
We need to ensure that the product is mapped to a selling plan, and this should be verified in both Loop and Shopify.
Product is mapped to the concerned product template
We need to make sure that the product is correctly mapped to the product template where the widget is hosted.
Selling plan mapped is available on storefront touchpoints
We need to make sure that at least one selling plan to which the product is mapped is set to available on the storefront.
Preference and edge cases check
This section covers the preference-based checks.
Hide widget if only one selling plan (for subscription-only products)
If we have set the product to be sold as subscription-only and mapped it to only one selling plan, and if the setting "Hide the subscription widget if only one selling plan is available" is enabled in the widget preferences, then the widget will not be shown.
Hide bundle selling plan preference for single-mapped bundle plans
If we have a product mapped to a single selling plan and it is also being sold as a bundle with that selling plan, and if the setting "Hide bundle selling plans on individual product pages" is enabled in the bundle preferences, then the widget will not be shown on that product page.
Product mapped to the same name, having 2 different selling plans.
In this scenario, if two selling plans have the exact same name and one of them is hidden from the storefront, then the widget will not be shown on the store.
Note: Shopify groups selling plans on the storefront based on their names. Hence, Shopify will consider only one selling plan as mapped.
Selling plan 1: Subscribe and Save
Selling plan 2: Subscribe and Save
Marked as hidden from the storefront
We can see the widget is hidden in this case
Tip: We recommend using different names in such scenario, for example- Subscribe and Save ----- Subscribe & Save
The merchant has done custom code to hide the widget in specific markets/countries.
If this is the case, then the widget will not be visible for those specific markets/countries.
Related articles
Here are some related articles that may offer additional insight and context.
How to set up Loop widget
Troubleshooting widget issues
Learn about selling plans
Need help?
No worries — we're here for you!
If you have any questions or need assistance, feel free to email us at support@loopwork.co or chat with us using the support beacon at the bottom right of your screen.
Regards,
Loop Subscriptions Team 🙂
Return to top
Updated on: 16/06/2025
Thank you!