How to Resolve: Shopify “App Block” disappearing from Theme Editor

When an app block—such as a product review widget, subscription portal, size chart, or trust badge—disappears from the Shopify Theme Editor, merchants cannot position or style the tool. In some cases, the block vanishes immediately upon saving; in others, it drops from the “Add block” menu entirely.

This error occurs when an app embed is disabled in the theme settings, the active page template uses the legacy .liquid format rather than modern .json architecture, the parent section schema restricts @app blocks, or the app was modified while installed on a draft theme.

How do I restore an app block that disappeared from the Shopify Theme Editor?

To restore a missing app block, navigate to the “App embeds” tab on the left sidebar of the Theme Editor and verify the app’s master toggle is turned on. Next, verify that the page uses a JSON template (such as product.json), confirm the parent section schema allows @app blocks, and ensure the app has not been uninstalled or de-authorized.

---

Fast Diagnostic Snapshot

Property	Value
Symptom	App block missing from “Add block” menu, or displays “App block not found”
Theme Architecture	Online Store 2.0 (OS 2.0) Section & Block Schema
Primary Culprit	App Embed disabled in the sidebar, or template is legacy Liquid rather than JSON
Secondary Culprit	Parent section max_blocks reached or missing @app in block types
Admin Route	Online Store > Themes > Customize

---

Step-by-Step Resolution

1. Verify and Activate the Master “App Embed” Toggle

Many modern apps split their functionality between two components:

1. App Block: The visual element placed inside a section (e.g., star ratings).
2. App Embed: The core JavaScript and CSS engine injected into the <head> of the site.

If the app embed is disabled, Shopify hides the corresponding app blocks from the Theme Editor to prevent broken, unstyled HTML elements from rendering on your live site.

Theme Editor Sidebar Navigation:
[Sections Icon]  ──> Manages visual layout and blocks
[Theme Settings] ──> Manages global typography and colors
[App Embeds]     ──> (CRITICAL) Manages app scripts and widget activation

The Fix:

1. In Shopify Admin, navigate to Online Store > Themes.
2. Click Customize next to your active theme.
3. On the far-left vertical toolbar, click the bottom icon labeled App embeds (three stacked cards with a small gear).
4. Search for the app in question.
5. Toggle the switch to On (Blue).
6. Click Save in the top right corner.
7. Return to the Sections tab, click Add block inside your target section, and verify that the app block now appears under the “Apps” heading.

If the app block appears but fails to load visual elements on the storefront, check for asset execution blocks using Fix: Shopify “Product Review” widget not appearing (JS Execution Order).

2. Check for Legacy .liquid Template Architecture

App blocks function only within Online Store 2.0 JSON templates. If your theme was upgraded from an older Vintage theme or contains legacy templates (such as templates/product.liquid instead of templates/product.json), the “Add block” menu will not support app blocks.

The Fix:

1. Go to Online Store > Themes > Actions > Edit code.
2. In the file explorer, expand the Templates directory.
3. Locate the template for the page where the block is missing (e.g., product.liquid or product.json):
   • If the file ends in .json, your template supports app blocks natively. Proceed to Step 3.
   • If the file ends in .liquid, you must convert it to JSON to support Theme App Extensions.
4. Converting a .liquid template to .json:
   • Copy any custom section references out of the product.liquid file.
   • Delete templates/product.liquid (or rename it to templates/product.old.liquid).
   • Click Add a new template, choose product, select JSON, and name it product.
   • Add your core product information section into the newly generated JSON file.
   • Return to the Theme Editor; app blocks will now be selectable.

If recent app updates or installations resulted in compilation errors across your layout files, follow Troubleshooting: Shopify “Theme Liquid Error” after App Install.

3. Parent Section Schema Limits and Missing @app Definitions

Shopify themes declare which blocks can exist inside any given section using a Liquid schema definition.

If a section does not explicitly include @app in its allowable block types, or if the section has reached its designated max_blocks limit, the Theme Editor will prevent the app block from appearing in the selection drawer.

The Fix:

1. Open Themes > Actions > Edit code.
2. Open the section file managing your page (for example, sections/main-product.liquid).
3. Scroll to the bottom of the file and locate the {% schema %} tag.
4. Inspect the "blocks" array: "blocks": [ { "type": "@app" }, { "type": "text", "name": "Text" } ]
5. If "type": "@app" is missing from the list, add it to the array.
6. Check the "max_blocks" property. If your section contains 16 blocks and "max_blocks": 16, delete an unused block in the Theme Editor to make room for the app block.
7. Click Save.

4. Clearing Stale Editor Cache and App Re-authorization

When apps update their Theme App Extension code on Shopify’s servers, your browser’s Theme Editor session may hold a stale schema cache. This causes the editor to display an “App block not found” error placeholder.

The Fix:

1. Completely clear your browser cache or open the Theme Editor in an incognito window.
2. In Shopify Admin, open Apps and launch the affected app.
3. Navigate to the app’s Settings or Installation page.
4. Click Verify Installation or Re-sync Theme Assets. This forces the app to refresh its registration token with Shopify’s Theme App Extension registry.

If you are also resolving custom data fields alongside missing app widgets, review Fix: Shopify “Metafield” data not rendering on Product Pages to ensure the widget has access to underlying product data.