Exporting a Dyspatch Template to Braze

Use Dyspatch and Braze together to simplify your email creation lifecycle and deliver engaging email experiences at scale.

Build and Approve in Dyspatch

In Dyspatch, use the drag and drop email editor to create a beautiful, responsive, and engaging email template. Collaborate with your team to approve the template and publish it.

Once your template is published, you can move it into your Braze account by exporting it with our Braze integration, or you can download your template to upload it to Braze manually.

Exporting a Published Template with the Braze Integration

With a Braze integration added to Dyspatch after you click Download/Export you can now select Export to Integration and send your Dyspatch template to your Braze account.

Exporting any newly published draft will update the template in Braze. Any changes to the name once published will also update the template in Braze.

Find your template in the Templates & Media > Email Templates section of your Braze account.

Download Your Template

You also have the option to download your template and upload it to Braze manually. Once you have published your template in Dyspatch you can select Download/Export within the Dyspatch editor. Braze supports Liquid as its templating language, so select Liquid and download your template. Any DML variables and templating logic will be translated to Liquid automatically.

Your download will be a zipped folder containing everything you need to get your template ready in Braze.

Add Your Dyspatch Template to Braze

Within Braze, select Templates & Media from the sidebar and create a new email template using the From File option. Select and upload the zip file downloaded from Dyspatch.

• Template Name: We recommend using the same name used for the template in Dyspatch.
  
• Sending Info: Enter your subject line from Dyspatch, you can find it in the metadata text file included in the Dyspatch download.
  
• Preheader: If you have already added a preheader in Dyspatch, you can leave the "Preheader" field empty.
  

Once you have finished building and previewing your email template save and you are done! Your template can be found in the Templates & Media > Email Templates section of your Braze account. You can now use this email template to start sending engaging email messages to your customers!

Custom Attributes

Custom attributes are a collection of users’ unique traits that can be called to tailor emails specifically for your recipients. This is stored in the User Profile on Braze. For more information, check out Braze's documentation on custom attributes

Custom attributes are flexible and have almost infinite use cases. The following data types are supported:

• Booleans (for example, a subscription status of true or false)
• Numbers (shoe size, waist size, ZIP code)
• Strings (items searched for, previously purchased items)
• Arrays (last 10 items searched for)
• Time (hours, days elapsed since last use of app)

Liquid

To display customer-specific content in your email templates, Braze utilizes Liquid, an open-source, customer-facing template language developed by Shopify.

Liquid displays dynamic content in objects, tags, and filters. Dyspatch supports the following:

• Objects are variables that are populated with external content. For example, {{${first_name}}} will insert a user’s first name into a message.
• Tags designate logic to populate content if conditions are met. For example, {% if ${location} == ‘USA’ %} will populate content if a user’s location has been set to ‘USA’.

Custom Attributes and Dyspatch

Dyspatch’s template and block builders allow you to test your custom attributes before exporting your completed templates to Braze. However, there is a slight syntactical difference between dynamic content in Dyspatch (DML) and in Braze (Liquid).

Objects

Calling an object in Dyspatch would appear as:

@{custom_attribute.${CUSTOM_VARIABLE_NAME}} from the following sample data:

{
  "custom_attribute": {
    "${CUSTOM_VARIABLE_NAME}": "variable value"
  }
}

Our integration recognizes this and exports to Braze as:

{{custom_attribute.${CUSTOM_VARIABLE_NAME}}}

Tags

The <dys-if> element allows you to conditionally display content, which is exported to Braze as a Liquid tag. In Dyspatch this would appear as:

  <dys-if cond="custom_attribute.${subscription_tier} == 'premium'">
      <dys-text>Hello subscriber!</dys-text>
  </dys-if>

With sample data of:

{
  "custom_attribute": {
    "${subscription_tier}": "premium"
  }
}

In Braze, this appears as:

{% if custom_attribute.${subscription_tier} == "premium" %}
  <tr>
    <td>
      <div>Hello subscriber!</div>
    </td>
  </tr>
{% endif %}

Filters

At this time, our Braze integration does not support exporting Filters. In order to include these elements in your Dyspatch templates (without a syntax error), we recommend using the <dys-raw> tag. Content placed inside of a <dys-raw> tag will be passed directly to Braze without being modified or parsed by Dyspatch. For more information, review this page from our DML documentation.

Frequently Asked Questions

• Where's my Braze import at?
  Once you've exported your Dyspatch template, it can be found in the Templates & Media > Email Templates section of your Braze dashboard.
  
  

• Why am I only seeing the mobile view of my template?
  If Enable inline CSS is active, Braze preproccesses your HTML by moving styles in a CSS stylesheet into the body of an HTML email. In some cases, this can lead to rendering issues. Since Dyspatch inlines CSS styles already, it isn't necessary to enable this functionality.

To turn off CSS inlining, navigate to the Sending Info tab of your HTML Composer, and the Advanced tab of the Drag & Drop Editor in Braze. This can also be set globally in Braze at Manage Settings > Email Settings > Inline CSS. For more information, please review this article on CSS inlining from Braze's documentation.

Learn More

Read more about working with Braze in Dyspatch on our Braze Integration page.