Why is my drawer not showing?
The most common question, and usually answered in one call.
Ask: "My cart drawer isn't showing on the storefront. What's wrong?"
Step 1 — Ask the store, not the theme
Call get_setup_health. It reaches a conclusion, and issues names the cause.
| Code | Fix |
|---|---|
APP_EMBED_DISABLED | Turn on the app embed in the theme editor, on the live theme |
THEME_NOT_OS2 | Switch to a theme that supports app blocks |
CART_DRAWER_DISABLED | Switch the drawer on in the app |
APP_BLOCK_CART_MISSING | Add the app block to the cart template |
APP_BLOCK_PRODUCT_MISSING | Add the app block to the product template |
NO_SETTINGS | Save the drawer settings once |
If normal is true and issues is empty, the drawer is able to render and the cause is
elsewhere. Go to step 2.
App embed settings do not carry across when you publish a different theme. A drawer that
"suddenly disappeared" is very often a theme that was published without the embed being switched on
in the new one — which is exactly what APP_EMBED_DISABLED on the live theme is telling you.
Step 2 — Separate "broken" from "never reached"
NO_IMPRESSIONS deserves its own step, because it is not a fault.
It means the drawer has never been shown to a shopper. Everything can be configured correctly and
still produce it. Check totalImpressions in the same result: if it is zero on a store with
traffic, the question is where the drawer is set to appear, not whether it works.
Step 3 — Check the feature, not the drawer
If the complaint is about one part — the reward bar, an upsell, the announcement — the drawer itself may be fine while that feature is switched off.
Call get_drawer_settings and read the flag for the feature in question:
rewardBarEnabled, upsellEnabled, announcementEnabled, giftWrapEnabled,
shippingProtectionEnabled.
NO_UPSELL_SETTINGS from step 1 is the related case: upsell is on, but nothing is configured for
it to show.
What you finish holding
Either a named cause with a fix, or a specific ruling-out: the drawer renders, it has been shown N times, and the feature in question is on or off. That is a far better support ticket than "the drawer isn't showing".