Articles on: Acquire

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.



In this article




Prerequisites


Before we dive into troubleshooting, it's important to ensure the following prerequisites are in place to avoid any setup-related issues.


  1. 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.
  2. 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.
  3. 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.


  1. 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.



  1. 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.



  1. 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.




  1. 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.


  1. 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.



  1. 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.




  1. 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.




  1. 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.


  1. 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.





  1. 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.




  1. 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


  1. 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.



FAQs


▶ Why did the Loop Subscriptions widget disappear from the product page, even though it was visible yesterday?

If the Loop widget has suddenly disappeared from the product page, one common reason could be that a bundle was recently created. In this case, go to the Loop app > Bundle > Preferences, and check if the setting "Hide bundle selling plans on individual product pages" is enabled. If it is, the widget will not show on any product that's part of a bundle, so you may need to disable this setting.

Additionally, ensure the product is still correctly mapped to a selling plan by going to Acquire > Selling Plans in the Loop admin, selecting the selling plan, and confirming that the product is listed there.

Finally, check if the widget is still linked to the product’s template by going to Acquire > Widgets in Loop, selecting the desired widget, and making sure the Shopify product template associated with the product is mapped to it. If any of these connections were changed or broken, the widget will no longer appear on the product page.


▶ Some people can see the widget on my website, while some people cannot see it. Also, the widget is not appearing on mobile devices.

If your widget is appearing on desktop but not on mobile (or vice-versa), try checking in incognito mode or clearing the browser cache. Additionally, there could be an issue with the markets setup on Shopify. Please review those settings as well. If the issue persists, raise it with support and we’ll get it checked.



Here are some related articles that may offer additional insight and context.




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: 14/07/2025

Was this article helpful?

Share your feedback

Cancel

Thank you!