How can I update the color of the subscription widget or Loop widget?
You can update the colors of your subscription widget from its Styles tab. Here's how:
Go to Loop > Acquire > Widgets
Click on the widget card you want to update
Open the Styles tab
Update the background color, border color, and other style options to match your brand
For more advanced customization, add your own custom CSS in the same section
Can't I have a different text color on the selling plan name that is not selected?
Yes, you can achieve this using the custom CSS option in the Styles tab of your widget. The general style settings don't allow separate colors for selected and unselected selling plan names.
How can I hide the selling plan selector title from the widget - what's the CSS class name?
The CSS class name for the plan selector title is loop-widget-sp-selector-label
You can hide it by adding the following CSS in the custom CSS section of the Styles tab:
.loop-widget-sp-selector-label {
display: none !important;
}
Why is the subscription widget not showing?
If the subscription 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.
For a detailed explanation of each issue and how to resolve it, refer to the widget troubleshooting guide.
The price shown in the Subscription widget does not get updated when switching / selecting variants, why is this happening?
You can fix this by calling Loop's widget update function whenever the selected variant changes. The implementation depends on how your Shopify theme handles variant updates - locate that logic in your theme code first, then do the following steps:
1. Get the product ID
Retrieve the product ID from the product form or a hidden input field.
const inputElement = document.querySelector('input[name="product-id"]');2. Get the selected variant ID
Obtain the newly selected variant ID from your variant selector logic.
const newVariantId = variant.id;
3. Call the Loop widget update function
Invoke the Loop function whenever the variant changes.
window.LoopSubscriptions.handleLoopWidgetVariantIdChange(
inputElement.value,
newVariantId
);
Why is the subscription widget not visible on my bundle page while it shows on normal product pages?
This is likely because the Hide bundle selling plans preference is enabled. To check:
Go to Loop > Acquire > Bundles
Open the Preferences tab
Under General, make sure Hide bundle selling plans is unchecked
How can I display multilingual translations on widget texts?
Multilingual translation for widget texts is available on the Pro plan. You can access it by navigating to Loop > Settings > Multilingual texts
My product page (PDP) shows 2 widgets and I want to remove one? How can I remove it?
If you're seeing more than one widget on your product page, it's likely that an app from another provider has added its own widget alongside Loop's. You'll need to remove the extra widget from Shopify > Theme.
To identify which widget is the duplicate, inspect your product page:
Open your website in Chrome.
Right-click anywhere on the page and select Inspect, or use CMD+SHIFT+C (Mac) / CTRL+SHIFT+C (Windows) to enable element inspection.
Click the "Select the element in the page to inspect it" icon (the arrow icon in the top-left of the inspector panel).
Hover your mouse over each widget and the widget brand name should appear in most cases.
Once you've identified the duplicate, remove it from your theme settings.
We recently published an updated version of our website theme and noticed
that the Loop subscription widget is not active. Can you assist us with adding the
plugin to the live theme?
If the Loop widget is not available on your new and recently switched theme, there is a high chance that your subscription widget isn’t mapped to any theme at the moment, and the Loop Subscription Widget App Block hasn’t been added in your new theme’s customisation. That’s why the subscription options aren’t appearing on your storefront.
Whenever you switch themes, you’ll need to follow a few quick steps to enable the subscription widget on the new theme.
Why can't I see the Loop option in my Shopify > Theme > Customise section?
Your theme may not be eligible for the Loop V2 widget. In this case, you can either switch to a theme that supports the V2 widget (for example, the Default theme) or use the V1 widget on your current theme. Please get in touch with the support team for help with the V1 widget.
Please provide the widget render code?
This is the widget render code -
{% render 'loop-subscriptions', type: 'product-widget', product: product %}
I have accidentally deleted Custom CSS in the Loop widget from the app. Can I retrieve it somehow?
You cannot retrieve Custom CSS once it has been deleted from the Loop widget. The CSS is stored in your theme and Loop has no way to recover it.
Why am I not able to add bulk templates to widget? If I add the templates and don't use the Map widget, would I still be able to add 10 more templates?
You can add up to 10 templates at a time. Once added, please map those templates before proceeding to add more.
Note: The maximum number of templates you can add in a single batch is 10.
How can I add the Loop subscription widget to a product's Quick View modal?
Since Shopify app blocks cannot be added directly to Quick View modal templates, the recommended approach is to render the product page content for the selected product within the modal. When the product page is loaded, the Loop subscription widget should be detected and displayed automatically.
If your theme does not support the automatic widget integration, you'll need to manually implement the Loop subscription widget (V1 widget) within the Quick View modal instead.
What is the logic for passing a selling plan to the Loop widget?
Here's how the selling plan logic works in the widget:
When One-Time is selected, the selling plan value inside the form becomes null.
When Subscribe & Save is selected, the form contains a selling plan value.
If the top form has a selling plan value, all products listed below display the price from the product JSON data under the selling allocation group.
If the selling plan value in the top form is null, the base price is shown in the variant selector below.
Whenever a selling plan price is displayed, the selling plan must be passed in the
add.jscall for Add to Cart.Only a single selling plan value can be passed in a single
add.jscall — multiple selling plan values are not supported.
How do I show an indicator or text if people hover over the widget?
To show an indicator text on the widget, here are a few things you can do:
Amend the details on the selling plan. (Applies to selling plan)
Change the text 'Purchase Options' from the widget itself. (Applies to all products)
If you need to do it for a few products is to:
Create a new widget template in Loop and link the relevant products
Create a new widget and attach those products by implementing option 2.
How to change the "Save to %" discount badge in the loop widget?
To change the discount badge , go to Loop> Acquire> Widgets> Texts> Discount badge text and make changes.
How do I edit the subscription details tool tip? I want to edit the part that appears when u hover over subscription details.
You can update the subscription details tool tip by navigating to:
Loop > Acquire > Widget > Select your widget > Texts > Subscription details description (HTML enabled).
From there, you can modify the content as needed.
Can I show a widget with custom quantity options using the quantity selector?
Loop does not directly control the quantity selector as it is independent of the widget, but you can try writing a custom js script to create a custom solution, OR use preset bundles.
How to change the colour of the Loop widget?
To change the colour of the widget, please head to the Aquire > Widget > Styles. In the Styles tab, you can change the background colour, border colour, and other style elements to match your preferences, and also add custom CSS for advanced options
Why did my widget disappear automatically, even when the selling plan was mapped?
Please check if recently made changes (like selecting an option) after A/B testing based on external app. There is a chance that a new selling plan may have been selected by default which might not have the products mapped, thus making the widget disappear.
I added the app block but the widget still isn't showing on my storefront. Why is this happening?
Make sure the theme is mapped to the widget after adding the app block. To check this:
Navigate to Loop > Acquire > Widgets.
Click on the specific widget card you want to add.
Under the Shopify themes mapped card, click Change.
Select the required theme you want to add the widget to. Then, for the required product template, check whether the App block status shows Added. If you can't find the required template, click Add more templates and add it.
If the App block status isn't Added, add it via the Action column.
Then click Map under Action.
Also check that you're adding the widget to the right theme and template.
If the theme is already mapped but the widget still isn't showing on your storefront, unmap it once, then map it again and check.
How can I add the widget to another template?
Navigate to Loop > Acquire > Widgets and click on the specific widget card. Under the Shopify themes mapped card, click Change, then select the required theme. If the template you want isn't listed, click Add more templates and add it. Once the template appears, check that the App block status shows Added (add it via the Action column if it doesn't), then click Map under Action.
Do I have v1 or v2 widget installed on my Loop?
In Loop Admin, check the Acquire menu in the sidebar:
If the menu shows Subscription Widget → your store has V1.
If the menu shows just Widget → your store has V2.
V2 is the current standard and offers more configuration options, such as Button Group layout, Radio Group layout, and multilingual text. V1 widget setup requires manually adding the widget to the Shopify theme liquid files, while V2 can be added as a Shopify section.
Can we test the Loop widget without making any changes to our live theme?
Yes, you can install the Loop widgets on a non-live (unpublished) theme to experiment and play around with the subscription set-up on your store before going live with the Loop.
For this follow the below steps:
Navigate to Loop > Acquire > Widgets > Click on the specific widget card
Under the Shopify themes mapped card, click Change
Then select the draft theme from the dropdown under "Select theme of your choice"
Can I customise the Loop subscription widgets?
Yes, you can fully customise the loop subscription widgets to match your brand's look and feel. The following aspects of the widget can be customized:
Widget layout: choose from radio group, button group, or checkbox.
Frequency selector: display frequency options as a dropdown or as buttons.
Preferences: control default selection, purchase option order, discount badge visibility, strikethrough pricing, selling plan description display, subscription details popup, prepaid plan pricing display, and more.
Styles: adjust background colour, border colour, border width, border radius, margins, padding, and other visual properties for each section of the widget. You can also add custom CSS.
Texts: Customise the default text labels on the widget to match your brand tone, including button text, plan names, and descriptions.
For a full walkthrough of every configuration option, refer to the widget configuration guide.
Which version of the Loop widget is compatible with the region-specific selling plans?
The latest V2 version of Loop is Compatible with the region-specific selling plans.
Can I remove the one-time purchase option on just one variant of the product?
No, you cannot remove the one-time purchase option for just one variant. You can only remove it at the product level, which applies to all variants.
To remove the one-time purchase option for all variants of a product, go to Shopify > Products, open the specific product, and under Purchase options, turn on "Only sell this product with these purchase options". This removes the one-time purchase option from all variants of that product in the Loop widget.
How can I remove the one-time purchase option from my widget - the product is only sold with subscriptions?
You can remove the one-time purchase option from your Loop subscription widget by setting the product to be sold only as a subscription in Shopify. For this:
Go to Shopify > Products, open the specific product
Under the Purchase options, turn on "Only sell this product with these purchase options".
This removes the one-time purchase option from all variants of that product in the Loop widget.
How do I make subscription option selected by default in the widget?
You can set the subscription option as the default in your Loop widget by updating your widget settings. For this:
Go to Loop > Acquire > Widgets > Click on the specific widget card which is mapped to the required theme
Go to the Preferences tab
Under "Option selected by default", select Subscription and click on save
Why is my Loop subscription widget not showing on the product page? I've checked every case to resolve this but the widget is still not appearing. What should I do?
If you've already checked all the cases in the documentation and the widget still isn't visible, the fix depends on which widget version you're using.
If you're on the Loop V1 widget, try to unpublish and republish the widget:
Go to Loop > Acquire > Widget Installation
Click "Unpublish subscription widget", then publish it again
If you're on the Loop V2 widget, try to remap the template:
Go to Loop > Acquire > Widgets and select the required widget card
Under the "Shopify themes mapped" section, click "Change"
For the required template, click unmap, then map it again
Can I show a strikethrough discount on one-time purchases, the way it shows for subscription purchases?
No, this is not natively supported in Loop. There is no built-in setting to display strikethrough pricing for one-time purchase options. It's only available for subscription purchases
You can achieve this with the help of your developers by using custom JS here