# Using the Email Builder Drag and drop blocks to assemble your email. Build, localize, edit, and preview email content all in one place without touching code. ## In the Email Builder Let's take a look at the elements that will help you assemble an email. ### Add Subject and Preheader click Add or Edit Subject and Preheader to add Subject and Preheader in the email builder Clicking **Add Subject and Preheader** above the email preview displays subject and preheader input fields. If a subject or preheader already exists, click the **Edit** icon next to the subject line.
The preheader, also sometimes called preview text, is the text that follows the subject line in an email inbox. Read more about preheaders.
#### Scribe AI Subject Line and Preheader Generator Use to auto-generate an engaging subject line and preheader based on the content of your email, or include your own custom prompt to tailor the suggestions. Click the Scribe AI wand icon in the subject line field to open the subject line generator drawer. Your email's content, along with your [Brand Guidelines](/administration/setting_brand_guidelines/), will be evaluated before the subject line and preheader are generated. You may also include additional information, such as the email's intention, audience, or goals. ![Subject and Preheader fields with arrow pointing to Scribe AI subject line generator icon and additional instructions field open below](https://docs.dyspatch.io/img/emails/email-builder-subjectline-scribe-icon.png) Submit your request and Scribe AI will offer a variety of subject line and preheader combinations to choose from. Either apply a suggestion or refine the suggestions to collaborate with Scribe. ![Four Subject line and preheader suggestions with Apply buttons next to them](https://docs.dyspatch.io/img/emails/email-builder-subjectline-suggestions.png) ## The Apps & Blocks Tab ![View of the email builder blocks tab](https://docs.dyspatch.io/img/emails/blocks-tab.png) In the Apps & Blocks tab are all the blocks and block folders assigned to the theme being used to build your email, as well as a selection of customizable layouts (if enabled in your account's settings). drag and drop a block into the email builder preview section Drag your blocks into the preview section and select a block to customize its content. Editing content in the blocks will automatically update the email preview on the right. #### Scribe Email Assistant Select the Scribe Email Assistant wand icon in the Apps & Blocks tab to open a chat panel where you can describe changes and let Scribe build or edit blocks for you. Read more in [Using Scribe Email Assistant](/emails/using_scribe_email_assistant/). ![The Apps & Blocks tab in the Email Builder with an arrow pointing to the Scribe Email Assistant wand icon](https://docs.dyspatch.io/img/emails/scribe-email-assistant-wand-icon.png) ## The Data Tab Add and select from different sets of data to preview your email's dynamic content. ### Template Preview Data Previewing Your Email With Template Preview Data Add test data as custom variables or in format in the **Data > Preview Data** tab. Enable the Template **Dynamic Data** to view the email with the Template Data values applied. Read more about [Testing Your Email With Template Data](/emails/testing_your_email_with_preview_data). ### Customer Profiles Previewing Your Email With Customer Profiles Customer Profiles are similar to Template Preview Data except that they're available in all emails in the workspaces where they're enabled and created under the [Customer Profiles Admin menu](https://app.dyspatch.io/admin/data/profiles). Store different data sets and scenarios to individualize email previews for your customer's unique status.
Preview Data and Customer Profiles are only for previewing in Dyspatch. Data they contain will not be used in your live emails
### Global Data Global Data is a set of variables available in all templates. Account administrators set up Global Data and Customer Profiles to help preview common data points.
When Dynamic Data inputs are combined and share variables, Customer Profile data takes precedence over Template Data, which takes precedence over Global Data.
### Variables in Use See all variables being used in your template by expanding the **Variables in Use** dropdown on the **Data > Preview Data** tab. ![Email builder Variables in Use dropdown expanded with sample variables listed](https://docs.dyspatch.io/img/emails/variables_in_use.png "class: idm img-size-75") ## The Localizations Tab ![Email builder localizations tab](https://docs.dyspatch.io/img/emails/email-builder-locale.png) The **Localizations** tab is where you create and manage different localized versions of your email. To learn more about , read our [localizing an email article.](/localization/localizing_an_email/) ## The Metadata Tab ![Email builder metadata tab](https://docs.dyspatch.io/img/emails/email-builder-meta-data.png "class: idm img-size-75") The **Metadata tab** is where you enter your ‘From’ and ‘Reply’ details for your email, such as ‘Sender’ and ‘Reply To’ names and email addresses. You can also see the email's ID on this tab and a list of all dynamic variables in use. Our [Setting Up Metadata](/emails/setting_up_email_metadata) article has more information available. ## Saving, Testing, and Submitting a Draft Previewing Your Email With Customer Profiles ### Autosave Changes to your draft are saved automatically by default. You can disable this setting in Profile Settings, accessed from the drop-down menu on the homepage. Autosaved and manual saved versions of the draft appear in Revision History. ### Revision History To review previously saved versions of the current draft, click the revision history icon next to the draft name. ### Email Guardrails Review [Email Guardrails](/emails/using_email_guardrails/) to catch any placeholder URLs, invalid dynamic data, and other commonly missed best practices. ### Create and Manage Drafts To create a new draft or view a list of existing drafts, click the draft name at the top of the email builder. Learn more about [draft stages and statuses](/emails/email_statuses/). ### Preview and Test Your Email Use the Preview button in the top menu bar to test your email on a variety of devices and email clients with [device testing](/emails/testing_with_device_previews/), or send a test email. ### Submit Your Draft Once it's ready, submit your draft for approval. Learn more about [submitting an email](/emails/submitting_an_email/). ## Accessing Email Revision History View, name, and restore previous saved versions of your email draft from the Revision History list. Click the revision history icon next to the draft name at the top of the email builder to open it. ![Revision history icon in top bar of Dyspatch Email Builder](https://docs.dyspatch.io/img/emails/eb-revision-history.png)
Autosaved versions are marked as such in the list if autosave is enabled for your account.
### Preview Previous Revisions Click a saved version from the list to view the template at that saved state. You can also review the template with Preview Data, review Metadata, and see Localization status in that revision. ![Revision history list of previously saved versions of a template, along with the preview data, metadata, and localizations tabs](https://docs.dyspatch.io/img/emails/eb-revision-history-list.png) ### Name a Revision Select **Name this version** from the " 3 dot " three-dot menu icon next to a revision to give it a custom name. ### Restore a Previous Revision Select a revision from the list, then click **Restore this Version**. Restoring adds a new copy of that revision to the top of the list — it doesn't overwrite your draft's existing history.
Users with Editor permissions can only view revision history. Developers and Admins can view, rename, and restore revisions
## Video Walkthrough Want to see our email builder in action? Check out our video walkthrough to learn some extra tips and tricks!