Why are my bundles not showing?
The most common question, and usually answered in one call.
Ask: "My bundles aren't showing on the storefront. What's wrong?"
Step 1 — Ask the store, not the theme
Call get_setup_status. It reaches a conclusion, and issues names the cause in the order worth
acting on.
| Code | Fix |
|---|---|
APP_EMBED_DISABLED | Turn on the app embed in the theme editor, on the live theme |
NO_BLOCK_ADDED | Add the app block where the widget should appear |
NO_ACTIVE_OFFERS | No offer is currently active — go to step 2 |
THEME_NOT_OS2 | Switch to a theme that supports app blocks |
NO_SETTINGS | Open the app's settings and save them once |
Fix the first one and stop. The rest are usually consequences. A store with the embed off often
reports several at once, and only APP_EMBED_DISABLED matters — nothing renders at all until that
is fixed.
App embed settings do not carry across when you publish a different theme. A bundle that
"suddenly disappeared" is very often a theme published without the embed switched on in the new one
— which is exactly what APP_EMBED_DISABLED on the live theme is telling you.
If issues is empty, the widget is able to render and the cause is in the offer. Go to step 2.
Step 2 — Separate "no offers" from "no active offers"
NO_ACTIVE_OFFERS does not mean the store is empty. Read offers in the same result:
| What you see | What it means |
|---|---|
total: 0 | Nothing has been created yet |
total: 12, active: 0 | Twelve offers exist and none is live — a scheduling or status problem |
For the second case, call get_offers with status: "scheduled" and then status: "expired". That
separates "starts next week" from "ended last month", which look the same from the storefront.
Ask for a limit here. The default is 10, and nothing in the answer says the list was cut short.
Step 3 — Check the offer itself, not the app
If one specific bundle is missing while others show, the app is fine and that offer is the problem.
Call get_offers to find its id, then get_offer_details. Read three things:
status— draft and expired offers do not render.startDate/endDate— a window that has not opened, or has closed.offerProducts— the products the offer is attached to. A bundle only appears on the pages of the products it targets. "It doesn't show" often means "I was looking at a different product".
Step 4 — Rule out the cap
If everything above is correct and offers still went quiet, call get_plan_status. On a capped
plan, is_capped: true means offers were switched off automatically when the cap was reached —
see Why did my offers stop mid-month?.
What you finish holding
Either a named cause with a fix, or a specific ruling-out: the embed is on, the block is placed, N offers are active, and this one targets these products. That is a far better support ticket than "bundles aren't showing".