Languages

Languages

One design, many languages. Translate the subject and the words, keep the layout.

A design can carry translations next to the original. A translation holds a subject, a preheader and the translated words of the blocks that need them. Rendering with a locale lays that over the original, so the layout, colors and images stay the same in every language.

In the editor

Open the Body panel, then Languages. Enter the language the email is written in, add a language code such asfr, ar or pt-BR, then fill in the subject and each block. Preview has a language picker once a translation exists. Right-to-left languages (Arabic, Hebrew, Persian, Urdu) flip the direction and mirror left and right alignment on their own.

In code

import { renderDesign, renderLocales, setTranslation } from "email-craft-sdk";

const next = setTranslation(design, "fr", {
  subject_line: "Bienvenue",
  blocks: { [headingId]: { text: "Bonjour" } }
});

const html = renderDesign(next, { fullDocument: true, locale: "fr" });
const all = renderLocales(next); // [{ locale, subject, html, direction, is_default }, ...]

API and MCP

POST /v3/render and POST /v3/emails take a locale. When no subject is sent, an email goes out with the translated subject. The MCP tools are set_translation, list_locales and a locale argument on render_design.

Good to know

• A language that has no translation renders the original.
• Only fields a block already has can be translated, and translated text is cleaned like any other text.
• The zip export is not localized yet.
• A countdown's end date is written in the email's language (body.lang), for example 31 ديسمبر 2026، 23:59 UTC in Arabic, and keeps its order in a right-to-left email.

Supported languages

The editor and every export work in any language Unicode covers. The 90 languages below (248 language and region codes) were each written into a design, saved, reopened, exported to HTML and plain text, and imported back from an HTML email, in the React, Angular, Vue and plain JavaScript editors, with nothing lost or changed. An imported email keeps its language (lang) and, for Arabic, Hebrew and the other RTL languages, its right-to-left direction. Typing was tested on the canvas for every script, and input methods (IME) for Chinese, Japanese, Korean, Malayalam, Hindi, Tamil, Bengali, Telugu, Vietnamese, Thai and Arabic.

• Set Text direction to right to left in the Body panel for Arabic, Hebrew, Persian, Urdu and the other RTL languages: columns flip, and text without its own alignment starts on the right, in the editor and in the email.
• No-break spaces (French 12 €, Czech 1 234 567) stay no-break in the plain text version.
• How a script looks in the inbox depends on the reader's fonts. Pick a font with a generic fallback; a web font with none (such as Lato) gets sans-serif or serif added in the export.

Try it in the demo

The live demo has a Language menu with the same 90 languages. It shows the sample email, the library templates and all 48 starter templates in the chosen language, right to left for Arabic, Hebrew, Persian, Urdu and the other RTL languages. Type into any block to check the script on the canvas.

Frequently asked questions#

Which languages does MailKaro support?

Any language Unicode covers. 248 language and region codes, including Arabic, Hindi, Chinese, Malayalam, Bengali and Amharic, were saved, reopened, exported and imported in the React, Angular, Vue and plain JavaScript editors with nothing lost.

Does MailKaro support right-to-left languages?

Yes. Set Text direction to right to left in the Body panel: columns flip, text without its own alignment starts on the right, and the export gets dir="rtl". An imported RTL email keeps its direction and language.

Can one design hold several languages?

Yes. A design carries translations of its subject, preheader and blocks, and rendering with a locale lays the translation over the original, so the layout stays the same.

Can I type Chinese, Japanese or Hindi with an input method?

Yes. Input methods (IME) were tested on the canvas and in the side panel for Chinese, Japanese, Korean, Hindi, Tamil, Telugu, Bengali, Malayalam, Thai, Vietnamese and Arabic.