The real symptom
The app is installed in Shopify admin but missing under Add block, Add section, or App embeds. It may work on one theme but not another.
Likely causes
- The merchant is looking in App embeds for an app block or vice versa.
- The wrong theme or template is open.
- The section does not support @app blocks.
- The app supports only Online Store 2.0 templates.
- The extension was not deployed or is stale.
- The app embed exists but is switched off.
Confirmed Community fix
Community threads resolve merchant-side cases by checking the live theme, correct template, Add block/section → Apps, and App embeds. Developer cases require confirming extension deployment and supported schema targets.
Exact admin path
- Go to Online Store → Themes.
- Confirm the live theme.
- Click Customize.
- Open the template where the app should appear.
- For inline widgets, use Add block or Add section and check Apps.
- For floating widgets or scripts, open App embeds and enable it.
- Save.
Simple checks
{% schema %}
{
"name": "App widget",
"target": "body",
"settings": []
}
{% endschema %}
For inline app blocks, confirm the host section schema supports { "type": "@app" }.
Do not do this
Do not paste old app snippets into theme.liquid before confirming whether the app now provides a theme app extension.

