# Email Editor

> The email editor is used for broadcasts, sequences, templates, automations, notifications, and confirmation emails. This guide explains how to build email content and review the message before subscribers receive it.

- Human page: https://mailrith.com/docs/email-editor
- Markdown page: https://mailrith.com/docs/email-editor.md
- Category: Campaigns & Delivery
- Reading time: 12 min read
- Last updated: 2026-06-13
- Related keywords: Email Editor, Email Editor documentation, Campaigns & Delivery, Campaigns & Delivery documentation, Mailrith documentation, Mailrith help, Where the Editor Appears, Content Building Blocks, Images and Unsplash, Personalization and Required Links, Autosave, Preview, and Tests, Troubleshooting, Email Templates, Broadcasts, Sequences

## AI Agent Notes
- Use this article as step-by-step Mailrith product guidance, not as legal, financial, or deliverability advice unless the article says so.
- Preserve exact Mailrith UI labels from the steps when explaining a workflow.
- Prefer Mailrith's product term Subscribers when referring to people on an email list.

## What this guide covers
Use Mailrith's editor to add text, sections, images, buttons, templates, personalization, previews, autosave, and test sends.

## Sections
- Where the Editor Appears
- Content Building Blocks
- Images and Unsplash
- Personalization and Required Links
- Autosave, Preview, and Tests
- Troubleshooting

## Visual Reference
![Mailrith broadcast editor showing an email campaign workflow.](https://mailrith.com/docs/screenshots/broadcasts.png)

The email editor appears in several Mailrith workflows. The surrounding feature decides when the message is sent and who receives it.

## Where the Email Editor Appears

Mailrith uses the email editor for broadcasts, sequence emails, email templates, automation send-email steps, internal notification steps, and double opt-in confirmation emails. Each feature has its own workflow, but you write, format, preview, and test the email in the same basic way.

Use the editor to create the message that subscribers or teammates will read. The feature around the editor controls when Mailrith sends the message and who receives it.

## Content Building Blocks

The editor supports plain text and reusable layout sections. Use text for simple copy. Add sections when the email needs columns, images, buttons, or a more structured layout.

- **Paragraph text:** use it for normal email copy, introductions, explanations, and closing notes.
- **Sections and columns:** use them to organize content into one-column or multi-column layouts.
- **Buttons:** add a clear call to action. Use one primary button when possible so readers can identify the most important action.
- **Images:** upload an image, reuse an image from the media gallery, or search Unsplash when Unsplash is available.
- **Dividers and spacing:** use them to separate sections and make the message easier to read.

Keep email layouts simple because inboxes are often narrower and less predictable than web pages. A clean single-column layout usually works better than a complex multi-column design.

1. Open the email draft from a [Broadcast](https://mailrith.com/docs/broadcasts.md), [Sequence](https://mailrith.com/docs/sequences.md), [Template](https://mailrith.com/docs/email-templates.md), automation step, or double opt-in confirmation email.
2. Write the main message in plain text before you add layout blocks.
3. Add sections only when those sections make the email easier to scan.
4. Add one primary button for the main action whenever possible.
5. Use dividers and spacing to separate ideas, not to decorate every line.
6. Preview the email before you send a test.

## Images, Uploads, and Unsplash

You can upload images from your computer and reuse images that already exist in the workspace. Use uploaded images for logos, product screenshots, event banners, and other brand assets.

When Unsplash search is available, Mailrith can add an Unsplash image with attribution. Use Unsplash for supporting imagery, not for proof of a product, venue, offer, or event. When readers need to understand something specific to your business, use your own real image whenever possible.

Add meaningful alt text to any image that communicates information. Alt text helps readers who use assistive technology and readers whose email client blocks images by default.

1. Place the cursor where you want the image to appear.
2. Click the toolbar button labeled **Add image**.
3. In the image drawer, upload a file, select an existing workspace image, or search Unsplash if that option is available.
4. Add alt text that explains the image if the image carries useful information.
5. Preview the email on mobile and confirm the image fits within the screen without taking up too much vertical space.
6. Send a test email and confirm the image loads in a real inbox.

## Personalization and Required Links

Email content can use subscriber data, such as names and custom fields, when those fields have values. Use personalization only when you trust the subscriber data. A plain greeting is better than an incorrect name or a blank personalized field.

Marketing emails should include an unsubscribe link. Mailrith-generated send flows use subscriber status and unsubscribe handling, but you should still review the email footer before sending. Confirm that the unsubscribe link is visible and that the unsubscribe path is easy to understand.

To add a direct preferences link, click **Insert Personalization** in the editor and choose **Preference Link**. This adds a **Manage Preferences** link that lets Subscribers manage send frequency and public topics without unsubscribing first. Keep the unsubscribe link available for Subscribers who want to stop all emails from the workspace.

To ask existing Subscribers for GDPR consent, first make sure the workspace **GDPR Consent** setting is turned on. Then click **Insert Personalization** and choose **GDPR Consent Link**. Use this link only when the message is a clear consent request. Subscribers who open it can choose email consent, advertising consent, or neither. Mailrith saves selected choices as GDPR tags; use those tags when you choose who should receive email.

## Autosave, Preview, and Test Sends

Mailrith saves drafts after you complete the required fields. Autosave helps protect your work while you write, but wait until saving finishes before you close the browser tab during important edits.

Preview the email before you send it. Use desktop preview to review the overall layout, and use mobile preview to find cramped columns, oversized images, long button labels, and awkward text wrapping.

Send a test email before a live send or sequence publishing. A test send lets you check the subject line, preview text, image loading, button links, personalization, and the message layout in a real inbox.

1. Wait for autosave to finish, or save manually if the page provides a save action.
2. Click **Preview** to open **Email Preview**.
3. Use the **Desktop** tab and read the email from top to bottom.
4. Use the **Mobile** tab and check line wrapping, button labels, images, and columns.
5. Use **Send Test Email** in the surrounding broadcast, sequence, or automation workflow to send the email to yourself or reviewers.
6. Open the test email in a real inbox and click every important link.
7. Return to the editor, fix any issues, and send another test if you changed the email.
8. Move on to sending, scheduling, or publishing only after the test email is correct.

## Editor Troubleshooting

- **A button link is wrong:** click the button, open the button settings, update the URL, and test the link again.
- **An image looks too large:** reduce the image size or move the image into a narrower section.
- **The mobile preview looks crowded:** simplify columns, shorten headings, and reduce side-by-side content.
- **Unsplash results do not load:** try a simpler search term or upload your own image.
- **A draft changed unexpectedly:** check whether you applied an AI draft, duplicated a template, or edited a saved version in another browser tab.

## Related Guides
- [Email Templates](https://mailrith.com/docs/email-templates.md): Email templates are your shared content library. Build structural layouts once, then reuse those layouts as starting points for broadcasts and sequence emails across your workspace.
- [Broadcasts](https://mailrith.com/docs/broadcasts.md): Use broadcasts for newsletters, product launches, announcements, and any message you send once to selected subscribers. Compose, target, test, and send or schedule the campaign in one workflow.
- [Sequences](https://mailrith.com/docs/sequences.md): Sequences send a series of emails over time as subscribers move through the steps. Use sequences for onboarding, nurture campaigns, and educational content that should be sent over days or weeks.
