Drag-and-drop email editor
Dashboard → Messages → Email Editor (/{org}/email-designs). Decision record: ADR-0027.
Dashboard → Messages → Email Editor (/{org}/email-designs). Decision record: ADR-0027.
Concepts
- Design (
edg_): a block document ({ version: 1, settings, sections[] }), subject and preheader. Scoped to an app. - Section: 1–4 columns, each containing content blocks. If no column width is given, the remaining width is shared equally; on mobile, columns stack vertically (this can be turned off in the section settings).
- Blocks: Text (rich text, Liquid), Image (alt text; can be marked decorative), Button, Divider, Spacer, Social (Facebook, X, Instagram, LinkedIn, YouTube, Pinterest, GitHub, web), HTML (raw code; tables and Outlook conditional comments are preserved).
- Saved blocks (
esb_): a section or block that can be dragged from the palette into other designs in the same app.
Saving and template versions
On every save, the design is validated on the server, compiled to MJML and HTML, and written as a new version of the linked email template
(email_subject, email_preheader, email_body). The first save creates a new template (tagged email-designer).
Campaigns, journeys and the API (template_id, template_version) use this template as usual; version history and rollback
are on the template screen. Deleting the design does not delete the template. To link to an existing email template, pass
template_id in the API (other channel fields are kept, email_mjml is removed).
Personalization
Liquid can be used in text, subject, link and image URLs ({{ user.tags.first_name | default: "friend" }},
{% if … %}, Data Feeds/Dynamic Content tags). The variable picker in the rich text toolbar inserts at the cursor position.
{{ unsubscribe_url }} and {{ preference_center_url }} are replaced with delivery-specific URLs at send time; if they are not used, a footer
is added automatically. The brand kit (ADR-0051) fills the {{ brand.primary_color }}, {{ brand.logo_url }}, {{ brand.font }} and
{{ brand.name }} variables; without a kit, these fields are empty strings. Variable output is HTML-escaped.
Preview
The Preview tab compiles the design with the same compiler the API uses for sending and shows it with sample personalization (first_name =
Ayşe). You can choose desktop/mobile (375 px) and light/dark theme. Dark theme simulates the behavior of clients that support
prefers-color-scheme: dark (Apple Mail, Outlook macOS/iOS); the colors are set in Document settings → Dark theme colors.
The tracking pixel, click redirects and unsubscribe links are added at send time.
Accessibility check
The list in the right panel updates live; clicking an issue selects the block:
- Image without alt text (unless decorative),
- Contrast below WCAG AA (normal text 4.5:1, large/bold text 3:1; including buttons and inline colors; also checked separately for dark theme colors if defined),
- Empty link (button, social, inline
href=""), button or link without text.
The check does not block saving; the same results are returned in the issues field of the API response.
Keyboard
Palette items are buttons: Enter/Space inserts after the selected block (otherwise into the selected section, otherwise at the end). With a block focused on the canvas, Alt+↑/↓ moves it up/down (crossing section boundaries), Alt+←/→ moves it to the adjacent column, Ctrl+D duplicates it, Delete removes it. Ctrl+Z undoes, Ctrl+Y or Ctrl+Shift+Z redoes (in form fields, the browser's own undo applies).
API (dashboard session)
| Endpoint | Description |
|---|---|
GET /internal/v1/apps/{appId}/email-designs | List (q, pagination) |
POST /internal/v1/apps/{appId}/email-designs | Create (name, subject, preheader?, document, template_id?, template_name?) |
GET/PATCH/DELETE /internal/v1/apps/{appId}/email-designs/{designId} | Detail / update (a content change creates a new template version) / delete |
POST /internal/v1/apps/{appId}/email-designs/preview | Compile without saving: html, mjml, warnings, issues |
GET/POST /internal/v1/apps/{appId}/email-saved-blocks, DELETE …/{blockId} | Saved blocks |
Reading requires the analytics.read permission, writing templates.write. An invalid document returns 400 (HS_VALIDATION_ERROR), a design without content
returns 422 (HS_CONTENT_INVALID), and a template linked to another design returns 409.
Security
Text and HTML blocks are sanitized on the server (scripts, iframes, forms, on* attributes and javascript: URLs are stripped).
In the dashboard, rich text and pasted content are reduced to an allowed subset; HTML blocks and the preview are shown in a script-free
(sandbox="") frame.
Email deliverability: warm-up, address validation and archive copy
Sending high-volume email from a new sender domain or IP damages your reputation and lands you in the spam folder. For this, Pushizo offers warm-up plans, pre-send address validation and a BCC/archive copy…
SMS
The SMS channel — Twilio and Netgsm providers, E.164 numbers, segment counting and Turkish characters, short links, STOP/START/HELP automation, MMS and inbound webhooks.