Appearance

Template Translation ​

Template Translation uses AI to translate your email templates into any language. You can translate the entire template at once or go block by block. The translation preserves your styling, structure, Merge Tags, and original tone.

It uses the same OpenAI integration as the AI Assistant, so if the AI Assistant is already configured, translation works without any extra setup.

Prerequisites ​

Before using Template Translation, make sure a valid OpenAI token is configured in your Plugin API token settings. Follow the instructions in this article to connect ChatGPT to your Topol Plugin.

How it works ​

There are two ways to translate content:

1. Whole-template translation ​

This translates all text and button blocks at once. You can trigger it from the top bar or from the language settings panel.

From the Top Bar:

When Multilingual Templates is not enabled, a Translate button appears in the top bar. Click it, pick a target language from the dropdown, and the whole template gets translated.

Translate button in Top Bar

From language settings (multilingual):

When Multilingual Templates is enabled, each language mutation in the language settings panel has a translate icon button. Clicking it translates the template content into that mutation. The result is saved directly into the mutation's translations.

Translate button in Language Settings

2. Block-level translation ​

You can also translate individual text or button blocks through the AI context menu. A Translate option now sits alongside Improve, Rephrase, Make Longer, and Make Shorter.

Translate option in AI context menu

If you're using Multilingual Templates, the block translates into the active language automatically. Otherwise, a language selector dropdown appears so you can pick the target language.

Custom Language Preset

By default, the language dropdown shows our predefined set of languages. You can replace or extend this list with your own languages using the customLanguagePreset option. See Custom Language Preset for configuration details.

Top Bar visibility ​

The translate button in the Top Bar is controlled by topBarOptions. If you're using topBarOptions to selectively show Top Bar elements, include "translate" in the array:

ts
const TOPOL_OPTIONS = {
  topBarOptions: [
    "undoRedo",
    "save",
    "changePreview",
    "translate", // show the Translate button in the top bar
  ],
};

If topBarOptions is not set or is an empty array [], all elements show by default, including the Translate button. See Top Bar And Window Bar for more on top bar customization.

INFO

The Translate button in the Top Bar only appears when Multilingual Templates is not enabled. When Multilingual is on, you access translation through the language settings panel instead.

  • Multilingual Templates: manage multiple language versions of a template. Template Translation writes directly into multilingual mutations.
  • AI Assistant: the inline writing assistant for improvements, rephrasing, and length changes. Translation is an action in the same AI context menu.
  • Custom Language Preset: define your own list of available languages in the translation dropdown.