# Localizing with Smartling


Our Smartling integration lets you sync your localization workflow between your Dyspatch account and Smartling project.

Dyspatch supports two levels of localization for your email — [Email Localization](/localization/localizing_an_email/),
for [editable content](/blocks_and_themes/using_editable/) that will change from email to email such as text content,
and [Block Localization](/localization/block_localization/), for content that will be consistent between emails, such as
headers and footers.

After you've completed the [Smartling integration setup](/integrations/smartling_setup/) process, you will be able to
sync both your email and block localizations to Smartling.

## Localizing Content

### Adding Locales

To get started, navigate to your email or block's **Localizations** tab and click **Add Locale** to add any locales that
you would like to sync with Smartling. Currently, this is only supported for individual locales, not
[locale groups](/localization/using_locale_groups/) if the group was added through the API.

![Arrow pointing to Create a Localization button in the Dyspatch Email Builder](https://docs.dyspatch.io/img/localizations/create-a-localization.png)

<div class="highlight note">Make sure all locales that you are using in Dyspatch are already set up in Smartling before syncing.</div>

### Syncing Content to Smartling

When your locales are ready, click **Sync to Smartling**, enter a name for your Smartling job, and click **Confirm &
Sync**.

<img class="img-border" src="https://docs.dyspatch.io/img/localizations/sync-to-smartling.png" alt="'Sync to Smartling' option in the Email Builder"/>

You will now see a progress bar in your editor which shows the current status of your localizations in Smartling. For email
localization, your content will now be
[locked for localization](/emails/email_statuses/#the-draft-stages-and-their-statuses),
meaning that no content can be changed.

Once the Smartling process is complete, we'll automatically update each locale in Dyspatch with the translated content
and unlock your email. For block localization, you can [bulk update](/blocks_and_themes/bulk_updating_blocks/) your
block so that your changes will appear in emails containing a previous version of the block.

<img class="img-border" src="https://docs.dyspatch.io/img/localizations/smartling-in-progress.png" alt="View Smartling Job Status in the Email Builder"/>

### Syncing a New Job in an Existing Smartling Project

If a template is updated and you need to sync it as a new Smartling job, you can reassign already-approved translations from the previous job to avoid retranslating unchanged strings.

#### Steps

**1. Sync to Smartling with a new job name**

From Dyspatch, sync the updated content to Smartling as normal but with a new name, for example, `Welcome Email - update`.

**2. Open the new job in Smartling**

In Smartling, click on the newly created job name to open it, then select the **Strings** tab.

**3. Filter by previously published strings**

Use the left-hand search panel to filter strings by:
- **Job Name**: select the original Job Name, `Welcome Email` in this case
- **Status**: select **Published**

This surfaces strings already approved and published in your previous job.

![Strings filtered by selected previous job name in Smartling](https://docs.dyspatch.io/img/integrations/smartling-published-jobs.png)

**4. Select all filtered strings**

Select all strings shown in the filtered results.

**5. Reassign to the new job**

Click **Actions → Change Job → Existing Job**, then select your new job.

![Selection modal of new job to reassign the translation strings to](https://docs.dyspatch.io/img/integrations/smartling-change-translation-job.png)

Your matching translations are now reassigned to the new job — no retranslation needed for unchanged strings.

## Video Walkthrough

Want to see our Smartling integration in action? Check out our video walkthrough!

<iframe width="560" height="315" src="https://www.youtube.com/embed/SepfvoH2Vpg" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>

<br/>

### Learn More

Read more about working with Smartling in Dyspatch on our [Smartling Integration](/integrations/smartling/) page.