Common issues and fixes
A short list of the things merchants ask about most when setting up the theme. Each entry tells you what you are seeing and what to change in the theme editor. Work from the symptom that matches your screen. For the messages the theme editor itself shows (unsupported section, placeholder notices, paused animations), see Theme editor warnings. For how sections, blocks, and presets fit together, see Sections, blocks, and groups.
A block reads "Block not found"
This message appears in the editor preview where a block should render. It usually means the block was left in a state the section cannot draw, most often a block that was partly removed or one that no longer fits its parent.
What to try, in order:
- Reload the editor. A stale editor state often shows this message after a theme update or a quick edit even though the live store renders fine, and reloading clears it most of the time.
- If it persists, open the section that holds the block and check its block list. If the affected block is empty or out of place, remove it, save, then add a fresh one with Add block and set it up again.
If the message appears across many sections at once, it is almost always the stale editor state from step 1, not a problem with each block. Reload and recheck before editing blocks one by one.
A section looks empty
A section can render with nothing visible for a few reasons. Check these:
- It has no content blocks yet. Many sections are empty containers until you add blocks (Sections, blocks, and groups explains why). Open the section and use Add block to add the content it expects (a heading, an image, a product, and so on).
- Its content points at nothing. A section tied to a collection, a blog, or a product shows nothing when that source is empty or unset. Open the section settings and pick a collection or blog that has items in it.
- It is hidden. Each section has a visibility toggle (the eye icon in the section list). If the section name is dimmed, click the eye to show it again.
If the section shows placeholder shapes instead of your content, it is rendering correctly but has no real data yet. Add the products, images, or collection it needs and the placeholders give way to your content.
Demo images are missing
The photographs in the demo are licensed for the demo store and do not transfer to your store when you install the theme. After install you will see placeholder shapes where those images were. This is expected.
To fix it, add your own images:
- Open each section that shows a placeholder.
- In the section or block settings, use the image picker to upload or select your own image.
- Repeat for every section that carries a placeholder.
Use your real product and brand photography. Reused stock or demo imagery weakens the store and can clash with the rest of your content.
The mega menu shows as a flat dropdown
The theme's rich mega menu needs two things set up together. If either is missing, the menu falls back to a plain dropdown list, which is the safe default.
- A navigation menu with the right depth. In your Shopify admin, under Navigation, the top-level menu item needs sub-items, and a third level under those to fill the columns with links. A top item with no children can only ever be a single link.
- A matching block in the header. In the theme editor, open the Header section and add a Mega menu block (or the Mega menu tabs block). In its settings, fill the Parent menu item field with the name of the top-level menu item it should expand. Capitalization and punctuation do not have to match, but the words do. With no matching block, that menu item stays a flat dropdown.
So the flat fallback almost always means one of: the menu item has no children, or there is no mega menu block in the Header whose Parent menu item matches it. Add the missing piece and the rich layout appears. Mega menu walks through the whole setup.
Note that mega menus are desktop only. Below 950 pixels wide the header switches to the hamburger menu, which shows the same navigation as nested lists.