My change shows in the builder but not on my store
My change shows in the builder but not on my store
Builder changes are a draft. Click Publish to put them live. See Publish.
The theme got an update but my store looks the same
The theme got an update but my store looks the same
A theme update is not applied by itself. Open Update theme in the builder, apply it, then publish. Files you changed keep your version unless you pick Use update. See Theme updates.
A platform fix was announced. Do I need to republish?
A platform fix was announced. Do I need to republish?
No. When the platform under
src/platform/ changes, published stores are rebuilt automatically from their published files. See Platform updates.Sale popups or live stats do not show
Sale popups or live stats do not show
They never show in the builder preview. Check them on your live store, and check Configure → Social proof and the product’s Live Stats card. These settings do not need a republish. See Social proof.
A JSON file has an error
A JSON file has an error
The editor marks the line. Common causes:
- A trailing comma after the last item in an object or list.
- Single quotes instead of double quotes.
- A missing comma between two items.
order exists in sections, and every id in block_order exists in blocks. If you cannot find the problem, undo your last change (Ctrl/Cmd + Z).Publish says a section or block type is unknown
Publish says a section or block type is unknown
The template uses a
type that has no folder in src/sections/, or a block type the section schema does not declare. Create the section, fix the type, or remove that entry. See Common checks.My edits to src/platform are gone
My edits to src/platform are gone
src/platform/ belongs to the platform. It is read-only in the builder and replaced on every build, so edits there never reach your store. Put your code in your own section, src/theme.tsx, src/theme.css or src/theme.ts, and import platform helpers from @/platform.A section shows an error in the preview
A section shows an error in the preview
The preview names the section and the message. Other sections keep rendering. Open the section’s file in Code, fix it, and the preview rebuilds. In Liquid, check for unclosed tags such as a missing
endif or endfor.An internal link works in the preview but not live (or the other way around)
An internal link works in the preview but not live (or the other way around)
Use store-relative paths such as
/products or /pages/about. In Liquid, pass them through | url. Do not hardcode your subdomain or domain.I can't add a section to a page
I can't add a section to a page
The section may be limited to other templates (
templates in its schema), already at its limit on this page, or have no presets. Main sections, such as the product page body, have no presets on purpose.
