Block Builder
Full-screen editor for chat block templates: block library, canvas, block settings, translations preview, and save.

You reach the Block Builder from Settings → Chat Blocks via New template or Edit, or directly at URLs like /settings/block-builder/{id} and /settings/block-builder/new (with query params for a new template).
Layout
The screen is usually split into these areas.
- Block library: draggable block types (containers, stacks, text, headings, product grids, repeat / if logic, and others your version ships).
- Canvas: hierarchical tree of blocks; reorder and nest by dragging.
- Block settings: when a block is selected, edit its data (copy, styles, merge tags, conditions).
- Preview: optional live or sample preview, including a ChatBox area on some builds to see the widget chrome alongside the home layout.
Merge tags
When the template is tied to an action, merge tags (often grouped in the UI) insert dynamic values from your store or integration. Use the documented placeholders; invalid tags may render empty in production.
Logic blocks
- Repeat: iterate over a collection from a merge source (with optional limit).
- If: show children when a test expression passes (operators such as truthy are available in-app).
These compile to structured JSON sent to the backend on save.
Translations
A Translations flow (modal or panel) lets you maintain strings per language where the product supports it, aligned with account Languages.
Save and exit
Use the header Save control before leaving. Navigate back to Chat Blocks when you are done. Unsaved changes may be lost if you close the tab.
Per-channel Appearance and Home page on a Chat channel can still override customer-facing behavior for that embed; templates are shared building blocks.
Last updated today
Built with Documentation.AI