Overview
If your Subi subscription widget isn’t appearing as expected, there are several common issues that could be preventing it from displaying correctly. This guide covers the most common troubleshooting steps to ensure your widget functions properly. Whether it’s a delay in installation, a missing product from your subscription plan, theme settings, or conflicts with other apps, we’ll walk you through the necessary checks and solutions to get your widget visible and working. Follow these steps to resolve the issue quickly.
Troubleshooting Your Subscription Widget
If your Subi subscription widget isn’t appearing on your store, follow these checks to find the issue:
Widget Issue | Description |
Wait for Installation |
|
Product Added to Subscription Plan |
|
Product Published |
|
App Embed Enabled |
|
Theme Changes |
|
No Conflicts with Other Apps |
|
Displaying Widget on Other Pages |
|
Manual Installation |
|
1. Wait for Installation
After enabling the Subi App Embed, it may take up to 1 minute for the widget to appear. Ensure you’ve waited at least 1 minute for the widget to fully install before checking for further issues.
2. Check If the Product Is Added to a Subscription Plan
Verify that the product is added to an active subscription plan in Subi. Only products included in a subscription plan will display the widget.
3. Ensure Your Product Is Published (Not in Draft Mode)
Make sure the product you want to display the widget for is not in draft mode. If it's unpublished, the widget will not show. To check this:
Go to Shopify Admin > Products.
Ensure the product is published and available for purchase.
4. Confirm That the Subi App Embed Is Enabled
The Subi widget requires the Subi App Embed to function properly. To enable it:
Go to Shopify Admin > Online Store > Themes.
Click Customize next to your live theme.
In the left-hand menu, navigate to App Embed and ensure that the Subi App Embed is enabled.
You can also do this from Subi. When the app embed is off in your live theme, your Subi home page shows a card titled Action required: the Subi app embed is off. Its Turn on app embed button opens your live theme in the theme editor with the Subi app embed already switched on, so you only need to press Save. Our article How do I use the Subi home page, and what do the plan statuses mean? walks through that card.
5. Check for Theme Changes
If you've recently changed your theme, you must enable the Subi App Embed for each theme separately. Even if the theme is unpublished, you can still preview the widget by ensuring the app embed is turned on for that specific theme.
A new theme in Shopify starts with app embeds off. If you publish a theme without first turning the Subi app embed on in it, the widget disappears from your product pages. Subi emails you when this happens, and when it finds a new draft theme without the app embed, as explained in Emails from Subi when the app embed is off below.
6. Ensure There Are No Conflicts with Other Apps
Other apps may conflict with the Subi widget. Common conflicting apps include:
Other subscription apps
Bundle apps
Pre-order apps
Back-in-stock apps
Automatic discount apps
Product option apps
If you suspect a conflict, ask Subi’s support team for assistance in sorting this out.
7. Are You Trying to Display the Widget on Other Pages?
If you are trying to display the widget on the homepage, collection pages, or quick view pages, make sure:
You’ve enabled the option to display the widget on these pages.
Your store is using an Online Store 2.0 theme for full compatibility.
To enable this, go to Subi Panel > Widget Tab and make sure the widget options for home, collection, and quick view pages are turned on.
8. Manually Install the Widget
If the widget still doesn’t appear, you can manually add it to your product page by following these steps:
Go to Shopify Admin > Online Store > Themes.
Click Customize next to your live theme.
Open the Product Template from the top menu.
In the Product Information section, click Add Block.
Search for Subi and select the Subi Widget Wrapper Block.
Drag the block to your preferred location on the product page.
For more detailed instructions, you can refer to the manual installation guide.
Emails from Subi when the app embed is off
Why did I get an email saying Subi's app embed is off in my live theme?
Subi emails you on the day the Subi app embed goes off in your live theme, because your subscription widget does not show on your product pages while the embed is off. The email's subject is Subi's app embed is off in your live theme, and it goes to the email address your store uses for Subi's emails. It usually follows the publishing of a new theme, since a new theme in Shopify starts with app embeds off, or someone switching the embed off in the theme editor.
Subi checks your live theme every day, whenever a theme is published, and whenever you open the Subi home page. If a theme without the app embed is published, the email arrives within minutes. If the embed is switched off in the theme editor of a theme that is already live, the email comes after Subi's next daily check, or right away if you open the Subi home page first.
You get one email each time the app embed goes off. If you turn it back on and it later goes off again, Subi sends a new email. Subi only emails when it sees the app embed go from on to off: if the embed was already off before Subi started sending these emails, you will not get one, but the card on your Subi home page still shows.
These emails go only to stores with at least one live subscription plan. If your store is paused in Shopify, Subi does not send them, since nobody can buy from a paused store, but the card on your Subi home page still shows.
Why did I get an email about a new theme?
Subi also emails you when it finds a new draft theme in your store without the Subi app embed. A new theme in Shopify starts with app embeds off, so if that theme were published as it is, your subscription options might not show on your product pages. The email's subject is Subi's app embed is off in your new theme, followed by the theme's name.
Subi looks for new draft themes once a day. You get at most one of these emails in any 7 days, however many new themes you add. Development themes and theme trials do not trigger it.
What does the Turn on the app embed button in the email do?
Both emails have a Turn on the app embed button. Use it on a computer: it opens the theme named in the email in Shopify's theme editor with the Subi app embed already switched on, so you only need to press Save. If someone else looks after your theme, you can forward the email to them.
What does We sell subscriptions another way do?
If you sell subscriptions another way and do not use the Subi subscription widget on your storefront, select the We sell subscriptions another way link in either email. A page opens confirming Got it. We won't ask again. You do not need to log in.
This choice is permanent. From then on, Subi stops sending app embed emails, both for your live theme and for new themes, and stops showing the app embed cards on your Subi home page. You can make the same choice from the Not now menu on the home page card.
The other item in that menu, Not today, only hides the home page card until the next time the app embed goes off. It does not stop the emails.
Need Help?
Feel free to contact our support team. We're here for you anytime:
Live Chat: Message us from within the Subi app or your Shopify Admin.
Email: Reach us at [email protected].
Want a hand with this? Book a free 30-minute setup call with our team.