Skip to main content

How do I use the Subi home page, and what do the plan statuses mean?

Learn what each section of your Subi home page does, how the setup guide works, and what Active, Inactive and Action required mean.

Your Subi home page is the first screen you see when you open Subi from your Shopify admin. It gives you a running picture of your subscription setup: what is still to do, how each subscription type is configured, and where to go next. This article walks through each section and explains what the statuses mean.

The Subi home page, showing the setup guide, performance metrics, app status and the six subscription plan types

When the Subi app embed is off in your theme

If the Subi app embed is off in your live theme, your Subi home page shows a warning card at the very top, above everything else on the page. Its title is Action required: the Subi app embed is off, and it reads Shoppers can't see your subscription option on your product pages until it is on. Your subscription widget loads through the app embed, so while the embed is off, shoppers do not see your subscription options.

Subi checks your live theme each time you open the home page, so the card reflects your theme as it is right now. If you have just turned the app embed on yourself, reload the page and the card goes away. This card is separate from the Action required status on a subscription type card, which is about a missing app block (see What each status means below).

The card only appears for stores with at least one live subscription plan. Subi also emails you on the day the app embed goes off in your live theme. Our article What to Do When Your Subscription Widget Doesn't Appear explains those emails.

Turning the app embed back on from the home page

To turn the Subi app embed back on, select Turn on app embed on the card. Subi opens your live theme in Shopify's theme editor in a new tab, with the Subi app embed already switched on, so you only need to press Save there.

While you are in the theme editor, the card on your home page changes to Switch on Subi in the theme editor, with the note Turn on the Subi app embed, save, and come back. This page updates by itself. If you closed the theme editor tab before saving, select Reopen theme editor to open it again.

Once you have saved, come back to the Subi tab. You do not need to reload it: as soon as Subi sees the app embed is on, the card changes to The Subi app embed is on, with the line Shoppers can now see your subscription option on your product pages. You can close this message with its close button. The next time you open the home page there is no card, as long as the app embed stays on.

If you do not want to turn it on now

Next to the button, the Not now menu gives you two choices, in this order:

  • We sell subscriptions another way — choose this if you do not use the Subi subscription widget on your storefront. The card disappears and Subi confirms with Got it. We won't ask again. From then on you will not see app embed cards on your home page, for your live theme or your draft themes, and Subi will not send you app embed emails. This choice is permanent.

  • Not today — hides the card, even when you reload the page, for as long as the app embed stays off this time. If you later turn the app embed on and it goes off again, the card comes back.

When a draft theme is missing the app embed

When the Subi app embed is on in your live theme, Subi also looks at your draft themes, the unpublished themes in your Shopify theme library. A new theme in Shopify starts with app embeds off, so if you published it as it is, your subscription options would disappear from your store.

If your newest draft theme does not have the Subi app embed, the home page shows a card for it. For a draft called Autumn refresh, the card reads Your draft theme Autumn refresh has no Subi app embed and Turn it on before you publish, or your subscription option disappears from your store. Subi looks for new draft themes once a day, so a draft you have just added may not have a card yet.

Select Turn on app embed in Autumn refresh (the button shows your draft's name) to open that draft in Shopify's theme editor with the Subi app embed ready, then press Save. Select Not today to hide the card for that draft. If you add another draft without the app embed later, it gets its own card. Development themes and theme trials are not treated as drafts here.

You only see one of these cards at a time. While the app embed is off in your live theme, the home page shows the live theme card and not the draft theme card, because your live store comes first.

New features for your shop

When Subi launches new features, your home page can show a strip near the top that reads, for example, 5 new features for your shop. The first time you open your home page after a launch, a panel called New for your shop opens on its own. After that only the strip shows, and you can select it to open the panel again whenever you like.

The panel lists the features picked for your store. The one marked Recommended for your shop is the feature we think fits your store best, and the others are marked New or Improved. Each has a button that takes you straight to where you set it up.

The strip only appears when there are new features for your shop, so you will not see it every time you open Subi.

Your setup guide

If you are still setting Subi up, a guide called Your path to your first subscriber appears near the top of the page. It shows one task at a time, along with a counter telling you how many of the steps you have finished.

The setup guide card showing two of three steps complete and the next step, customize the widget to match your brand

The guide tracks three things: turning on the Subi app embed in your theme, creating your first subscription plan, and customizing the subscription widget to match your store. You do not need to tick anything off by hand. Each step marks itself complete as soon as you have done it, so the guide always reflects your real setup.

Once all three steps are done, the guide disappears on its own. You can also close it at any time using the X in its top right corner, whether or not you have finished every step.

Your subscription types at a glance

Below the setup guide you will find your performance metrics, your app status, and then a card for each subscription type Subi offers: Subscribe & Save, Build a box, Membership, Fixed Bundle, Volume Discount and Mystery Box.

Six subscription type cards showing Active, Action required and Inactive statuses

Each card tells you three things: whether you are using that subscription type, whether its storefront setup is complete, and what the most useful next step is. The button on each card changes to match, so you are always one click from the right place.

What each status means

The coloured label on each card describes the state of that subscription type:

  • Active — you have at least one plan of this type and its storefront setup is complete. Nothing needs your attention.

  • Action required — you have a plan of this type, but a block it needs is missing from your theme, so it may not appear correctly to shoppers. The card's button becomes Add block so you can fix it straight away.

  • Inactive — you have not created a plan of this type yet. The card's button becomes Create if you would like to start one.

One card may also carry a Recommended star. This marks the subscription type Subi suggested for your store based on the answers you gave when you first set the app up.

What the app block labels mean

Next to the status you will see how many app blocks that subscription type uses. Selecting the question mark beside it opens a summary of each block and how it is currently set up:

  • Via app embed — the app embed shows this widget on your product page, so no block is needed. To show the widget on other pages, or to change where it appears on the product page, add the block in your theme editor.

  • Added — you have placed this block in your theme yourself.

  • Not added — this block is not in your theme yet. If the subscription type genuinely needs it, the card shows Action required.

The difference between Via app embed and Added matters when you are troubleshooting. A widget marked Via app embed is being shown by the app embed rather than by a block you placed, so turning the app embed off in your theme will remove it. If that happens in your live theme, the card described in When the Subi app embed is off in your theme appears at the top of your home page.

Creating a new subscription plan

Selecting Create on any card, or Create plan from the Subscription plans page, opens the plan type picker. It shows the same six subscription types with an illustration of how each one appears to your shoppers, along with the same status and app block information as the home page.

The plan type picker showing all six subscription types with illustrations

Choose the type you want and Subi takes you to the right plan builder for it.

Next steps

If the card at the top of the page reads Action required: the Subi app embed is off, start there — while the app embed is off, shoppers cannot see your subscription options at all. Select Turn on app embed and save in the theme editor.

If a subscription type card shows Action required, look at that next — it means shoppers may not be seeing that subscription option correctly. If you are still getting set up, follow the setup guide from the top of the page.

You can also select Book a call in the top right of the home page to arrange time with the Subi team. If anything on the page does not match what you expect, contact our support team and we will take a look with you.

Did this answer your question?