Why isn't my app's embed showing up on my store even though the app is installed?
A short, ordered checklist for why an app's embed won't show up or work on your storefront, and where the real documentation actually lives, so you don't burn days chasing scattered threads.
What's going on
You installed an app that's supposed to add something to your storefront, like a chat widget, a tracking pixel, a badge, or a banner, and nothing shows up. You check the app's own settings page and it looks fine. You search the exact symptom and land on a scattered mix of Shopify Community threads, old blog posts, and half-updated developer docs, each describing a slightly different piece of the puzzle: theme editor settings, extension folder structure, block targets, theme versions. None of them is wrong exactly, but none of them is the whole picture either, and stitching it together yourself can genuinely eat a week.
The frustrating part is that the actual fix is very often trivial, a single toggle you haven't found yet, but the path to discovering that toggle is buried across developer documentation written for people building extensions, not merchants troubleshooting them, plus old community posts describing bugs that may or may not still apply to your theme and app version.
Why it happens
Shopify deliberately ships app embed blocks in a deactivated state after installation. This is by design, not a bug: an app's developer has no way to force something onto every merchant's storefront automatically, so activation is a manual step that lives in the theme editor's App embeds panel. Merchants who don't already know that panel exists reasonably assume the app itself is broken.
The documentation genuinely is split across audiences. Shopify's developer docs describe how an app embed is built: the extension's folder structure, its configuration file, and whether a block's target is a section (an app block, added inside a section by the merchant) versus the page head or body (an app embed, toggled globally). That's essential if you're debugging the extension's code, but it isn't written for a merchant just trying to turn a feature on, and Shopify's merchant-facing help content doesn't fully bridge the gap.
On top of that, several separate but similarly-shaped issues get tangled together in search results: older themes not supporting app blocks at all, browser caching making an already-fixed toggle look broken, a visibility toggle in the editor being accidentally switched off, and at least one reported case where having multiple app embeds active at once caused one app's saved block settings to stop displaying in the editor. Each of these produces the same symptom, "the app doesn't show up," so merchants end up testing all of them in sequence with no clear order of priority, which is exactly what turns a five-minute fix into a week.
5 ways to fix it
Start with the Theme Editor, not the docs
Before touching documentation, open Online Store > Themes > Customize, find the App embeds panel in the editor's left sidebar (usually reached via a small icon separate from the section list), and check whether the app's toggle is switched on. This single step resolves the majority of "the app isn't working" reports, because Shopify ships app embed blocks in a deactivated state by default after install — installing an app does not automatically turn it on anywhere on the storefront.
Work through a short checklist before assuming anything is broken
Rather than reading scattered blog posts, verify these in order: is the embed toggled on in App embeds for the theme you're actually previewing or have published; is that theme the one that's actually live, since duplicate or draft themes are a frequent trap; is the section or block visibility toggle in the editor sidebar switched on; and is your browser showing a cached page, which you can rule out by testing in an incognito window. Writing this down once, as your own store's runbook, replaces re-discovering it from forum threads every time.
Know the two extension types and their required folder layout
If you or your developer are building or debugging the extension itself, a theme app extension has a defined structure: an extensions/<name>/ folder containing assets, blocks, snippets, and locales subfolders plus a shopify.extension.toml configuration file. Blocks meant to float or inject site-wide, such as chat widgets, pixels, or compliance tags, target the head or body of the page and surface under App embeds. Blocks meant to be dragged into a section by the merchant target a section instead, and only appear on templates whose section schema allows app blocks. Mixing these up, for example building a section-targeted block and then wondering why it never shows up in App embeds, is a common source of multi-day debugging.
Check for known multi-embed quirks and theme-version mismatches
Some merchants have reported that when several app embeds are active at once, one app's block settings stop displaying their saved values in the editor, and that toggling other embeds off restores them. If settings seem to vanish only when multiple apps are enabled together, it's worth testing for this before assuming your own app is broken. Separately, confirm your theme is on the newer Online Store 2.0 architecture (JSON templates) rather than an older Liquid-only theme, since older themes don't support app blocks at all and app embeds can behave inconsistently on themes that were never upgraded.
If it's still not resolving, isolate with a fresh theme and escalate
Duplicate your live theme, or start from a free reference theme like Dawn, and test the app embed there in isolation. This quickly tells you whether the problem is the app, your specific theme's code, or a customization conflict. If the embed still won't activate or render after all of the above, that's the point to contact the app's own support, since they can confirm their extension's configuration, rather than continuing to search general forums, as embed rendering issues are often specific to one app's code.
Bottom line
None of this requires new software, it's a sequencing problem: check the free, native App embeds toggle first, confirm you're on an Online Store 2.0 theme, and only look at the extension's own code structure if the toggle and theme are already correct. Keeping a short internal checklist like the one above is what actually saves the time, not more documentation reading. If you're evaluating several installed apps at once and want a faster way to see which embeds are active, misconfigured, or silently conflicting, a lightweight store health or app-audit tool can surface that in minutes instead of you re-deriving the checklist for each app.
Browse the rest of the problem library, run a free storefront scan to catch issues like this automatically, or email us and we'll work out a custom solution for it.