Chat widget builder
Full-screen editor for chat widget templates: block library, canvas, block settings, translations preview, and save.
You reach the builder from Settings → Chat Widgets via Create or Edit, or directly at URLs like /settings/chat-widgets/{id} and /settings/chat-widgets/new (with query params for a new template).
Layout
The screen is usually split into:
- 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 Widgets 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 2 days ago
Built with Documentation.AI