Translations

Workflow translations

Novu supports multi-language translations for workflows, allowing notifications to dynamically adapt to each of your subscriber's preferred language. You can enable, configure, and manage translations across your notification workflows from the Novu dashboard.

Each workflow can support multiple locales. Novu automatically selects the correct translation based on the subscriber’s locale.

Benefits:

• Deliver notifications in the subscriber's preferred language
• Customize content per workflow or layout
• Improve communication across geographies

Manage translations from the translation page in the Novu dashboard. Set a default language and add target languages as needed.

Enabling translations

To use translations for a workflow, you need to enable them on the workflow level.

While creating a new workflow

• Turn on the Enable Translations toggle
• Set the default locale, such as en_US or en_GB
• Add the target locales you wish to support, such as fr_FR, es_ES, ja_JP

While editing an existing workflow

• Open an existing workflow
• Turn on the Enable Translations toggle
• You don't need to take any action if the toggle is already on

You can configure the default and targeted locales on the translation page.

Translation groups

A translation group contains all language variants for a workflow identified by a unique workflow ID.

You can:

• Search for groups on the translations page
• View status per locale ('Outdated' or 'Up to date')
• Import or export translations for a specific locale, such as en_US
• Import or export translations for all workflows where translations are enabled

Translation JSON format

Each locale supports JSON-based translation files. For example, the en_US.json file contains the default translations for the workflow. You can update the translation JSON files using the JSON editor on the translation page.

{
  "in-app": {
    "title": "Welcome to Novu!",
    "message": "Hi {{subscriber.firstName}}, let's get started!"
  },
  "email": {
    "subject": "Get Started",
    "body": "Thank you for joining us, {{subscriber.fullName}}"
  }
}

You can update translations by editing the JSON files in the editor on the translations page or by exporting and re-uploading them.

Exporting and importing translations

If you prefer to create/update translations in a JSON file outside the Novu dashboard, you can do so by exporting and importing them.

How to import translations

• Navigate to the translations page.
• Select the workflow you want to export translations for.
• Click on the locale, such as en_US, now click on the download icon to download the latest default locale translation JSON file.

How to export translations

• Navigate to the translations page.
• Select the workflow you want to import translations for.
• Click on the locale, such as en_US, now click on the Import Language(s) button to upload the translation JSON file.
• Novu detects the locale automatically using the file name

💡 Translation changes in default locale such as en_US will mark other locales as Outdated, needs update

Master JSON file

Master JSON file is a JSON file that contains the default locale's translations keys of all the workflows where translations are enabled. You can import or export this file from the translations page. Below is an example of a master JSON file:

{
  "workflows": {
    "events-publish": {
      "key": "value"
    },
    "events-update": {
      "subject": "A new update",
      "content": "{{payload.eventName}} event has been updated"
    }
  }
}

Using translation keys in step content editor

In Email or In-App editors, use {{t.key}} to insert a translatable string. If the key already exists for the locale, it appears in the suggestions list.

Clicking Add to Translations automatically adds a new key to default locale.

Example:

{{t.subject}} → "Let's get you started"
 
{{t.product.details.description}}

Testing translations

Use the Preview Context to:

• Simulate subscriber locale such as fr_FR or ru_RU
• Preview step content for the selected language.
• Update or correct missing translations on the fly.

Keeping translations up to date

Any edit to the default locale will invalidate others. You’ll see a warning: Outdated, needs update. Re-export the default, update translated files, and re-upload.

Disabling translations

A translation group can be disabled by clicking on the three dots and selecting Disable & delete translations. This action is irreversible and removes all associated translation data.

Translation in email layouts

This feature is currently a work in progress. If you need translation support in email layouts, reach out to us at support@novu.co

Best practices

• Always finalize your default content before exporting.
• Avoid hardcoded language in the content editor.
• Use variables and translation keys consistently.
• Set subscriber locale properly to deliver notifications in the correct language.