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
Before troubleshooting, confirm the following are in place.
Shopify 2.0 theme: Your store must be built on a Shopify 2.0 theme, as only these support app block-based integrations. To verify, navigate to Online Store > Themes > Customize. If you see App Blocks in the theme editor, you are on 2.0. If not, consider upgrading your theme or switching to a compatible one.
Product page compatibility: Confirm that the product page template and its main section support Shopify app blocks so the Loop widget can be added to it.
Widget enabled in Loop: In Loop, verify that the widget has been created and its status is set to Enabled.
Common reasons for widget not showing up
If the widget is not visible on your product page after installation, it is usually due to one of the following reasons:
The storefront widgets master switch in Loop admin is turned off.
The specific widget mapped to the product page is not set to Active.
The widget is not mapped to the correct theme or product page template.
The Loop subscription widget app block is missing, hidden, or deleted from the product template in the Shopify theme editor.
The product is in draft state or not available on the online store sales channel.
The product is not mapped to any selling plan in Loop or Shopify.
The product is not assigned to the correct product template where the widget is hosted.
The selling plan mapped to the product is not set to be available on storefront touchpoints.
The "Hide the subscription widget if only one selling plan is available" preference is enabled, and the product has only one selling plan.
The "Hide bundle selling plans on individual product pages" bundle preference is enabled, and the product is part of a bundle with a single selling plan.
Two selling plans with the same name are mapped to the product, and one of them is hidden from the storefront.
Custom code has been added to hide the widget in specific markets or countries.
Refer to the sections below for detailed troubleshooting steps and solutions for each scenario.
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 you 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.
To resolve this, navigate to Loop > Acquire > Bundles > Preferences. Then uncheck the "Hide bundle selling plans on individual product pages" option if it's enabled
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.
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
We recommend using different names in such scenario, for example- Subscribe & Save
4. 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?
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, common reasons could be that either a new theme was created, or the selling plan is not mapped or the bundle was recently created.
In case of a new selling plan, please ensure that 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.
In case of the product-specific challenges, please 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 would no longer appear on the product page. If you create a new theme, you need to make sure the widget is properly mapped and installed on the new live theme.
In case it's a new bundle, go to the Loop app > Acquire > 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.
In case the widget design has changed and the widget is appearing as text instead of the full design, you may need to untick: Loop > Acquire > Widget > Preferences > Untick 'Show the plan selector as text if only one selling plan is available'.
The widget is visible on desktop but not on mobile (or vice versa). How do I troubleshoot?
The widget is visible on desktop but not on mobile (or vice versa). How do I troubleshoot?
Try the following in order:
Clear browser cache and test in incognito mode: cached JS can cause widget to not render.
Check Shopify Markets: if the store uses Markets and the widget's selling plan is restricted to certain markets, it may not display in markets where the customer's currency/location doesn't match.
Check theme compatibility: some custom themes override CSS in ways that hide the widget on mobile. Inspect the element to see if it's present in the DOM but hidden by CSS.
Raise with Loop support if the issue persists: include a screen recording showing the behaviour on both devices.
I am seeing the error: 'Variants can only be purchased with selling plans'? What does it mean and how can I resolve it?
I am seeing the error: 'Variants can only be purchased with selling plans'? What does it mean and how can I resolve it?
This error typically occurs for a few situations:
a) When the product is part of a bundle that requires a selling plan, or
b) When purchase type of product is 'Sell as subscription only' in Shopify, or
c) Please ensure that the Product is not in 'Draft' state in Shopify, or
d) It is marked 'available' for 'Online store sales channel', etc.
If the issue still persists after verifying these points, please contact our support team for further assistance.
Why am I getting the error 'Liquid error (line 2505): Could not find asset snippets/loop-subscriptions.liquid' instead of the widget on the product page (PDP)?
Why am I getting the error 'Liquid error (line 2505): Could not find asset snippets/loop-subscriptions.liquid' instead of the widget on the product page (PDP)?
This error typically occurs when the Loop subscription snippet is missing from your theme.
If you're using GemPages, the widget may not automatically add the required snippet. Please check your GemPages setup and refer to this GemPages help article for guidance: https://help.loopwork.co/en/articles/12742337-gempages
Why am I getting error: "Loop Widget: Error loading Loop subscriptions widget: No widget found for template:"
Why am I getting error: "Loop Widget: Error loading Loop subscriptions widget: No widget found for template:"
Please go inside the Widget Settings and map the template to solve the error: "Loop Widget: Error loading Loop subscriptions widget: No widget found for template:"
This issue is due to the product template not being mapped correctly. Please update the template under the widget settings, and it shall start working as expected.
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 🙂