# Localizing with Phrase


Our Phrase integrations let you sync your localization workflow between your Dyspatch account and Phrase 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 (like your text
content), and [Block Localization](/localization/block_localization/), for content that will be consistent between
emails (like headers and footers).

Once your [Phrase Strings integration](/integrations/phrase_strings_setup/) or
[Phrase TMS integration](/integrations/phrase_tms_setup/) has been set up, you will be able to sync both your email and
block localizations to Phrase.

## 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 Phrase.

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

Add your localization's Name and [Language Code](/localization/supported_languages/). Add any more languages now before
syncing with Phrase.

![Modal for creating a localization in Dyspatch](https://docs.dyspatch.io/img/localizations/adding-locale.png)

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

## Syncing Content

If using Phrase TMS, see [Syncing to Phrase TMS below](#syncing-to-phrase-tms).

### Syncing to Phrase Strings

When your [locales](#adding-locales) are ready, click **Sync to Phrase Strings**, enter a name for your Phrase job, and
click **Confirm & Sync**.

![Sync to Phrase strings option in the Email Builder](https://docs.dyspatch.io/img/localizations/phrase-strings-sync-to.png)

You will now see a progress bar in your editor which shows the current status of your localizations in Phrase. 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.

![View Phrase Job Status in the Email Builder](https://docs.dyspatch.io/img/localizations/phrase-in-progress.png)

Navigate to your Phrase account and complete the translation job.

![Completed job in Phrase Strings account showing completed icon](https://docs.dyspatch.io/img/localizations/phrase-strings-completed-job.png)

Once the Phrase process is complete, we'll automatically update each locale in Dyspatch with the translated content and
unlock your email.

<div class="highlight note">If your job is complete in Phrase, but now being pulled into Dyspatch, refresh the page to force a pull of localizations from Phrase Strings</div>

### Syncing to Phrase TMS

When your [locales](#adding-locales) are ready, click **Sync to Phrase TMS**.

![Sync to Phrase TMS option in the Email Builder](https://docs.dyspatch.io/img/localizations/phrase-tms-sync-to.png)

Enter a name for your Phrase job, pick the Project Template you'd like to use, then click **Confirm & Sync**.

![Phrase TMS Sync modal with Project Template selection drop down menu expanded](https://docs.dyspatch.io/img/localizations/phrase-tms-select-project-template.png)

You will now see a progress bar in your editor which shows the current status of your localizations in Phrase. 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.

![View Phrase Job Status in the Email Builder](https://docs.dyspatch.io/img/localizations/phrase-in-progress.png)

Navigate to your Phrase TMS account and complete the translation job.

![Completed job in Phrase Strings account showing completed icon](https://docs.dyspatch.io/img/localizations/phrase-tms-completed-job.png)

Once the Phrase process is complete, we'll automatically update each locale in Dyspatch with the translated content and
unlock your email.

<img class="img-border" src="https://docs.dyspatch.io/img/localizations/preview-email-localizations.gif"
alt="Gif of selecting a translated locale in the Email Builder, displaying the French and Spanish text content"/>

For block localization, you may want to [bulk update](/blocks_and_themes/bulk_updating_blocks/) your block so that your
changes will appear in your emails.

<div class="highlight note">If your job is complete in Phrase TMS, but now being pulled into Dyspatch, refresh the page to force a pull of localizations from Phrase TMS</div>