Linked blocks
A linked block is a special insert mode: every inserted instance stays connected to the library entry. Change the content in one place and the change propagates automatically to all other linked instances and to the library block itself.
Ideal for content that appears identically on many pages and should be maintained centrally (e.g. a promotion banner).
Create a linked block
- Save a block as described in Blocks and enable the Save as linked block toggle.
- Insert the block from the Saved blocks category into one or more pages.
Every instance inserted this way belongs to the same sync group.
How to recognise a linked block
- The block shows a Linked badge in the editor.
- The right sidebar shows a highlighted Linked block info panel with the library block's name.
- A tooltip on the badge explains the sync behaviour and points to Show usage in the block library.
Editing content
Recommended: visually in the editor
Edit any linked instance directly in the editor like any other block. The change is applied automatically:
- Immediately to all other linked instances on the same page.
- Shortly after to the library entry and – after the next page save or storefront request – to instances on other pages.
For advanced users: via the sidebar
| Action | Effect |
|---|---|
| Edit linked block | Opens a JSON editor for the library block config. Save and sync propagates the change to all instances. |
| Unlink | Breaks the connection. The block becomes a normal static copy. |
JSON editor for technical edits only
The Edit linked block dialog expects valid JSON. For normal content changes, editing visually in the editor is the recommended and safer path.
What exactly gets synced
- The slot contents are synced (text, media, links inside the block).
- Page-specific wrapper settings such as CSS class, margins or background colour are not synced – they stay page-local.
- On a sync, all language variants are overwritten with the same content. Language-specific overrides on individual instances are not preserved – use static blocks for those.
Tracking usage
In the Block Library, the Show usage action lists which Shopping Experiences use each entry. Unused blocks are marked Not used.