PushizoDocs
Channels

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)

EndpointDescription
GET /internal/v1/apps/{appId}/email-designsList (q, pagination)
POST /internal/v1/apps/{appId}/email-designsCreate (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/previewCompile 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.

On this page