# Exporting a Dyspatch Email to Iterable


Use our integration with <a href="https://iterable.com/features/email/" target="_blank">Iterable</a> to deliver engaging email experiences to your customers.

## Build and Approve in Dyspatch

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

Once your email is published, you can move it into your Iterable account by exporting it with our [Iterable Integration](/integrations/iterable_setup/), or you can download your email to upload it to Iterable manually.


### Exporting a Published Email with the Iterable Integration

With the Iterable integration added to Dyspatch and your email published, click **Export** and select your Iterable integration.

![Iterable card to select from the export to integration modal](https://docs.dyspatch.io/img/exports/export-iterable.png)

Review or edit the email details for export and click **Confirm & Export**.

![Confirm export details modal with email name field](https://docs.dyspatch.io/img/exports/export-iterable-details.png)

Exporting any newly-published draft will update the email in Iterable. Any changes to the name, once published, will also update the email in Iterable.

#### Ensuring Dyspatch Styling with Iterable

Next, find your email in the **Content > Templates** section of your Iterable Projects dashboard. Open the email in the Email Designer and click "Edit Design". Open "Preferences" and make sure the "Convert CSS to line styling" is **not** checked.

![Arrow showing edit design option for a template in Iterable.](https://docs.dyspatch.io/img/exports/iterable-edit-design.png)

![Arrows showing preferences button in bottom left of Iterable email designer and the convert css to line styling checkbox deselected.](https://docs.dyspatch.io/img/exports/iterable-email-preferences.png)

<div class="highlight note"> Failing to remove CSS inlining in Iterable may cause issues with some email clients.  </div>

Your email is now ready to please and delight your customers!

## Adding Email to Iterable Without Direct Integration

Move your email to Iterable manually if you don't have the Iterable direct integration.

### Getting Your HTML Source Code

#### Downloading or Copying Your Email
Once your email has been reviewed and [approved by your team](/emails/submitting_an_email/#draft-approved), you can now export your email using the **Export** button.

Either select **Copy > HTML** or click the download icon under Iterable on the **Download Email** tab of the export modal. Alternatively, you could select the **HTML/Handlebars** option, which SendGrid uses as its templating language.

![Download Email modal with arrow pointing to download icon under the Iterable logo](https://docs.dyspatch.io/img/exports/iterable-download-email.png)

A zipped file will be downloaded onto your system with the HTML, plain text content, metadata, and localizations (if applicable).

<div class="highlight note">Copying the HTML from the export modal will not include the localized versions of your email</div>

#### Adding the Email to Iterable

Unzip the downloaded file on your system, then navigate to <a href="https://app.iterable.com/templates" target="_blank">Content > Templates</a>. In the top-righthand corner, select **Import email template**. From here, you can upload the HTML file you downloaded from Dyspatch.

![Uploading an HTML file directly to Iterable](https://docs.dyspatch.io/img/exports/iterable-template-upload.png)

Next, go into the template editor by clicking "Edit Design", then click "Preferences", and make sure the "Convert CSS to line styling" is **not** checked.

![Arrow showing edit design option for a template in Iterable.](https://docs.dyspatch.io/img/exports/iterable-edit-design.png)

![Arrows showing preferences button in bottom left of Iterable email designer and the convert css to line styling checkbox.](https://docs.dyspatch.io/img/exports/iterable-email-preferences.png)

Populate the fields for sending information, including _Subject Line_, _Plaintext_, and _Preheader_ text, and save your template. The import is complete, and your email is ready to send.

For information on how to send emails via Iterable, review <a href="https://support.iterable.com/hc/en-us/articles/205538575-Sending-Your-First-Campaign" target="_blank">Sending Your First Campaign</a> from Iterable’s documentation.

## Frequently Asked Questions

### **What Locale setting do I need to change in Iterable?**
Iterable recommends adding Locales based on <a href="https://en.m.wikipedia.org/wiki/List_of_ISO_639-1_codes" target="_blank">two-letter ISO country codes</a>. For the integration to work successfully, your Dyspatch email must have both a language *and* country code. For example, a French-language email needs its locale specified (i.e. *fr-FR* versus *fr-CA*) For more information on setting locales in Iterable, review <a href="https://support.iterable.com/hc/en-us/articles/213279923-Supporting-Multiple-Languages" target="_blank">this article</a> from their documentation.

### **What's the difference between locale and language format?**
The language format refers to the first part of the previously mentioned two-part localization codes. French, for example, would appear as *fr*. The locale refers to the region that the content your email is targeted towards. While *fr-FR* (French, France) and *fr-CH* (French, Switzerland) may be written in the same language, the content of the email may differ for any number of reasons.

### **How can I preview the localizations from my Dyspatch export in Iterable?**
On your Iterable dashboard, navigate to **Templates > Edit Template**. In the top-right corner, select the localization you'd like to view in the preview pane at the bottom of the page. Iterable will indicate whether or not a localization exists for that template.

<img class="img-border" src="https://docs.dyspatch.io/img/exports/iterable-locale.png" alt="Selecting a localization to preview in Iterable"/>

### **Why doesn't my sent email match what's in Dyspatch?**
Iterable automatically converts CSS content to a format that typically works better for email. Since Dyspatch emails are ready to send as-is this can cause problems when sending. To resolve this, open the template in Iterable, go into the template editor by clicking "Edit Design", then click "Preferences", and make sure the "Convert CSS to line styling" is **not** checked.

![Arrows showing preferences button in bottom left of Iterable email designer and the convert css to line styling checkbox deselected.](https://docs.dyspatch.io/img/exports/iterable-email-preferences.png)

### Learn More
Read more about working with Iterable in Dyspatch on our [Iterable Integration](/integrations/iterable/) page.
