Skip to content

Creating a drag-and-drop email

Using the drag-and-drop editor for email, you can create completely custom and personalized email messages for either campaigns or Canvases, all without using HTML to build your email body.

Not sure whether your email message should be sent using a campaign or a Canvas? Campaigns are better for single, simple messaging campaigns, while Canvases are better for multi-step user journeys.

Once you’ve selected where to build your message, let’s dive into the steps to create a drag-and-drop email.

Step 1: Select your template

After selecting the drag-and-drop editor as your editing experience, you can choose to:

  • Start with a blank template.
  • Use a Braze drag-and-drop email template.
  • Use a saved drag-and-drop email template.

You can also access all templates from the Templates section.

After selecting your template, you’ll see an overview of your email under Email Variants that includes the sending information and email body. Click Edit Email Body to begin designing the email structure in the drag-and-drop editor.

Step 2: Build your email

The drag-and-drop editing experience is divided into three sections: Sending Settings, Content, and Preview & Test. The magic of building your email body happens in the Content section. Before building your email, it’s important to understand the key components that guide your email-building experience.

Drag-and-drop email components

The drag-and-drop editor uses Content and Rows as the two key components to simplify your workflow, without additional use of HTML.


Content includes a series of tiles that represent different types of content you can use in your message. These are organized into three categories: basic, media, and advanced.

Basic blocks

Basic blocks are the foundation of your email. Using these blocks, you can add any of the following elements into your email body:

  • Title
  • Paragraph
  • List
  • Button
  • Divider
  • Spacer
Media blocks

With media blocks, you can add different visual content such as images, videos, social media icons and links, and customizable icons.

Advanced blocks

Although the drag-and-drop editor simplifies your workflow with these blocks, you can also use advanced blocks to insert HTML or to add a menu to your email body. Note that using your own HTML may affect how the message is rendered.


Rows are structural units that define the horizontal composition of a section of the message by using columns. You can either empty rows or Content Blocks.

Using more than one column allows you to put different content elements side by side. This way, you can add all the structural elements you need to your message, regardless of the template you selected when you started.

Now that we’ve reviewed these key components, let’s use these blocks to build our drag-and-drop email.

  1. Select the Rows panel. Drag and drop the row configurations into the main editor. This will map the layout of your email content. Note that new configurations must be dragged to the top or bottom of an existing section.
    • When you select a row configuration, the Row Properties settings appear for further customization for row background colors, images, and custom column sizes.
  2. Select the Content panel. Drag and drop your desired content tiles to the row components.
    • You can also drag any of the Content tiles into the main editor. This creates a row for the tile.
    • You can further refine the tile by selecting the tile and adjusting the fields in Content Properties and Block Options. This includes editing letter spacing, padding, line height, and more.

Check out More creative details for other ways to further customize your drag-and-drop email.

As you build your email, you can toggle between a desktop and mobile view to preview how your email messaging will look for your user groups. This will check that your content is responsive, and you can make any necessary adjustments along the way.

Step 3: Add your sending information

Once you’ve finished designing and building your email message, it’s time to add your sending information in the Sending Settings section.

  1. Under Sending Info, select an email as the From Display Name + Address. You can also customize this by selecting Customize From Display Name + Address.
  2. Select an email as the Reply-To Address. You can also customize this by selecting Customize Reply-To Address.
  3. Next, select an email as the BCC Address to make your email visible to this address.
  4. Add a subject line to your email. Optionally, you can also add a preheader and a whitespace after the preheader.

A preview in the right-hand panel will populate with the sending information you’ve added. This information can also be updated by navigating to Settings > Email Preferences > Sending Configuration.


Under Sending Settings, you can add personalization for email headers and email extras, which allows you to send additional data back to other email service providers. Personalizing an email header, such as including a recipient’s name, can also contribute to the likelihood of your email being opened.

Step 4: Test your email

After adding your sending information, it’s time to finally test your email.

Go to the Preview and Test section. Here, you have the option of previewing your email as a user or sending a test message. This section also includes Inbox Vision, which allows you to check that your email has rendered correctly across different mobile and web clients.

Because you can view three different versions of the same email in the actual editor, in Inbox Vision, and as an actual test email, it’s important to align the details across all your platforms.

Preview and test send

Under the Preview as a User tab, you can select the following user types to preview your message.

  • Random User: Braze will randomly select a user from the database and preview the email based on their attributes or event information.
  • Select User: You can select a specific user based on their email address or external ID. The email will preview based on that user’s attributes and event information
  • Custom User: You can customize a user. Braze will offer inputs for all available attributes and events. You can enter any information you would like to see in the preview email.

Use Inbox Vision

Inbox Vision allows you to view your email campaigns from the perspective of email clients and mobile devices. To test your email message using Inbox Vision, select Inbox Vision in the Preview & Test section and click Run Inbox Vision.

After using the drag-and-drop editor to design and create your email message, continue to build the remainder of your campaign or Canvas.

About the updated HTML engine

The underlying engine that produces HTML from the drag-and-drop editor has been optimized and updated, resulting in benefits related to HTML file compression and rendering.

Our average exported HTML data footprint size has been reduced, leading to faster loading and rendering, reduced mobile clipping, and reduced bandwidth consumption.

HTML rendering has improved based on the following updates that minimize the number of conditional comments and CSS media queries. As a result, HTML files are smaller and more efficiently coded.

  • Migration from a <div> element-based design to a standard <table> formatted codebase
  • [Editor blocks][7] have been re-coded for conciseness
  • Final HTML code is compressed to remove whitespace between tags
  • Transparent dividers are automatically converted into content padding

More creative details

As you continue building drag-and-drop emails, you can further customize each email body by using a combination of these creative details to capture your audience’s attention and interest in your message.

Auto-width images

Images added to your email will automatically be set to Auto width. To adjust this setting, toggle off Auto width and adjust the width percentage as needed.

Auto width option in the Content tab of the drag-and-drop editor.

Color layering

Using color layering, you can change the color of the email background, content area, and different content components. The color ordering from front to back is: content component color, content area background color, and background color.

Example of the color layering in the drag-and-drop editor.

Content padding

Block Options for the drag-and-drop editor.

To adjust padding, scroll down to Block Options and select More Options. You can fine-tune your padding to get your email looking just right.

Content background

You can add a background image to your row configuration, allowing you to incorporate more design and visual content in your email campaign.

Add personalization

Options for adding personalization for the drag-and-drop editor.

Basic Liquid is supported in the drag-and-drop email editor. To add personalization to your email:

  1. Select Personalization under the Content section.
  2. Select the personalization type. This includes default (standard) attributes, device attributes, custom attributes, and more.
  3. Search for the attribute to be added.
  4. Copy your generated Liquid snippet and paste it into a content block in your email body.

Liquid personalization is not supported for image blocks and button link type fields.

Dynamic images

You can choose to include dynamic images in your email messaging by including Liquid in your image source attribute. For example, instead of a static image, you can insert{{first_name}} as the image URL to include a user’s first name in the image. This helps personalize your emails to each user.

When using links, buttons, images, and videos in the drag-and-drop editor, select Add new attribute under Attributes in the Content section to append additional information to HTML tags in emails. This can be especially useful for message personalization, segmentation, and styling.

A common use case is to insert an attribute into your anchor tag to disable click tracking when sending through Braze.

  • SendGrid: clicktracking = "off"
  • SparkPost: data-msys-clicktrack = "0"

Another common use case is to flag specific links as universal links. Universal links are links that redirect to your app, giving your users an integrated experience.

  • SendGrid: universal = "true"
  • SparkPost: data-msys-sublink = "open-in-app" (a custom sub-path must be configured)

To set up universal links, refer to Universal links and App Links.

Alternatively, you can integrate with one of our attribution partners, such as Branch or AppsFlyer, to manage universal links.

New Stuff!