Visual Builder
The Visual Builder is a drag-and-drop email editor powered by GrapesJS. It opens as a modal inside your WordPress admin and is available wherever you see the “Open Visual Builder” button — both inside campaign editing and transactional email editing.
Interface overview
- Left panel — Blocks: Drag content blocks from here onto the canvas
- Center — Canvas: The email design surface; click any element to select it
- Right panel — Properties & Styles: Edit the selected element’s content, spacing, colors, and other CSS properties
- Top toolbar: Undo/redo, toggle device preview (desktop/mobile), save, and close
Available blocks
-
Text — paragraph or heading text; type merge tags
like
{{first_name}}directly into the element - Image — upload an image or enter a URL; set width and alt text in the right panel
- Button — styled link button; set the label and URL in the right panel
- Divider — horizontal rule for visual separation
- Columns — side-by-side column layout; drag other blocks inside each column
- HTML — raw HTML block for custom or advanced content
Using merge tags
Type merge tags directly into text elements on the canvas. They are
preserved in the output HTML and replaced with real values at send
time. Available tags: {{first_name}},
{{email}}, {{site_name}},
{{site_url}}. In Confirmation emails only:
{{confirm_url}}.
Saving your design
- Click the Save button in the top toolbar
- The builder closes and returns the generated HTML to the campaign or transactional email editor
- The output uses inline CSS — it is already optimized for email client rendering
- To make further changes, reopen the builder by clicking “Open Visual Builder” again
Troubleshooting the builder
- Builder modal opens blank: A JavaScript conflict with another admin plugin is likely. Try deactivating other plugins one by one, or switch to Chrome.
- Blocks won’t drag or canvas is unresponsive: Same root cause — JS conflict. Check the browser console for errors.
- Saved content not appearing in editor: Check the browser console for errors. As a fallback, switch the editor mode to Raw HTML and paste your content directly.
- Columns layout looks broken in the email client: Not all email clients support multi-column layouts. Use a single-column layout for maximum compatibility, or test thoroughly before sending.
Next: Shortcode Reference
Dispatch Pro
Premium self-hosted email marketing for WordPress. Everything in Core, plus the Visual Builder, customizable transactional emails, and CSV import/export.
Quick Links
- Overview
- Requirements
- Installation
- Configuration
- Managing Campaigns
- Subscriber Management
- Transactional Emails
- Visual Builder
- Shortcode Reference
- Troubleshooting
Need support?