Enable app in theme

Sami Product Labels renders everything through Shopify’s App Embed block. Until that block is enabled in your active theme, nothing the app creates appears on your storefront.

Caution

This is the single most common reason a badge doesn’t show. A badge set to Active still stays invisible while the app embed is off.

1. Open the app

   In your Shopify admin, find Sami Product Labels under Apps in the left sidebar and open it. The app opens on its Dashboard.

   

   Open the app from your Shopify admin.

2. Check the status chip

   On the Dashboard, look at the chip beside the Explore outstanding features heading:

   Chip	Meaning
   App embed active	The embed is on for your live theme — you are done.
   App embed inactive	The embed is off. Continue to the next step.

   The refresh icon next to the chip rechecks the status without reloading the page.

   Note

   The chip only reports your live (published) theme. It does not check draft or unpublished themes — see Working with more than one theme below.

   

   The chip beside “Explore outstanding features” reports the embed status.

3. Turn on the app embed

   In your Shopify admin, go to Online Store > Themes and click Customize on your active theme. Then:

   1. Open App embeds in the left sidebar of the theme editor.
   2. Find Sami Product Labels in the list.
   3. Toggle the switch On.
   4. Click Save in the top-right corner.

   

   Toggle on the app embed, then save the theme.

   Danger

   Saving is what applies the change. Closing the theme editor without clicking Save leaves the embed off.

4. Verify

   Go back to the app Dashboard and click the refresh icon beside the status chip. It should now read App embed active.

   Still inactive? Reload the page, then repeat the previous step and confirm you clicked Save in the theme editor.

Working with more than one theme

The app embed is a per-theme setting.

Caution

Enable it separately in every theme you publish. Switching your active theme, duplicating a theme, or installing a new one means repeating these steps for that theme — badges will silently stop showing otherwise.

Note

App embeds require an Online Store 2.0 theme. If yours doesn’t support them, contact us at [email protected] for alternative installation methods.

Testing on a draft theme

The Dashboard status chip is tied to your live theme only, so it stays on App embed inactive while you work on a draft — even after you have turned the embed on there. That is expected, and it does not stop badges from rendering.

To preview badges on a draft theme:

1. Go to Online Store > Themes and click Customize on the draft theme.
2. Open App embeds, toggle Sami Product Labels On, and click Save.
3. Preview the draft theme — your badges render as usual.

Note

Enabling the app embed is the only step needed on a draft theme. Ignore the Dashboard chip while testing; it will switch to App embed active once you publish that theme.

Next steps

• Quickstart — create your first badge.
• Troubleshooting — what to check when a badge still doesn’t show.
• Badges & Labels overview — the full feature set.