Dyspatch offers block localization to make it easier to build and localize templates. Block localization is helpful for translation consistency across emails. Localize a Block to translate content to different countries, regions, or languages. Localizations are available with all Teams accounts and can be managed in the email builder or via the Dyspatch API.

Getting Started

To get started head to the themes and blocks page in your account and select the theme you want to work with.

Dyspatch theme's page

Mark Content for Translation

In order to make content from your block localizable, add the attribute "localizable" to content you wish to translate. After this step you will able to translate the content in your block.

Using the localizable attribute in the Code tab

  <a href='https://example.com' class='gray-link' localizable='link-1'>My Account</a>

Creating Localizations

The next step is to navigate to the "Localizations" tab, from here you can create a localization and give it a name your team will recognize. This name is for your reference only and can follow any naming convention that works for your team.

Localizations tab in Dyspatch

Creating and naming a Locale

Translating Your Content

To translate your content you can either do this in the "Localizations" tab and add the translations you want in Dyspatch, or you can create localizations by uploading a PO file. You can translate any content, for example: images, texts, links and more.

Once you're happy with your translated content and have the localizations you want for your blocks, you can then save it and use that block in your themes and templates.

Next Steps

After you've saved the block to your theme and added it to the template editor, you can then view preview your localizations.

Preview a Localization

Preview template with localized content

The localizations you’ve created are available for device previewsDevice PreviewsView how your email looks when opened in different devices and email clients. and test sending in the Preview area. Select a localization from the drop-down to preview the localized version of your template on selected devices.

Export Localizations

Once you're happy with your translated content and have published your template you can export your template and all the localizations by selecting Download/Export in the editor. Inside the downloaded zipped file will be your localizations in HTML and plain text.