Create and manage module translations

Translate and publish versions of modules so field labels display in a global team's preferred language in the content editor. Module translations support multilingual teams by localizing field labels in their account default language while keeping the same basic module logic.

Before you get started

Before creating module translations, review the requirements and limitations to understand how translated modules display in the design manager and the content editor.

Understand requirements

• Module translations must be created manually. 

Understand limitations & considerations

• Module translations affect only field labels and code. Page, post, or article content is translated separately.
• Translated field labels display based on a user's account default language. 
• Each translated module can be customized independently in the code editor.

• Module translations are limited to languages supported for default content creation. Learn more about default content creation languages.

Create translations of a module

1. In your HubSpot account, navigate to Content > Design Manager. 
2. In the finder, click on the name of the module you want to translate, or create a new module.
3. In the inspector, click Add translations. This action will create a source module in the account defaults language.

4. Click the Add translations dropdown menu and select a language to create a translated version of the module.

Edit the source module

Edit the source module to add comments or make structural changes.

1. In the finder, click the name of the module.
2. In the inspector, click the module's original translation (e.g., English (master)) to open the code editor.
3. In the code editor, click the pencil icon edit or click into the code editor to add fields, comments, or other content to this translated version of the module.
4. Enter text to add comments or edit the module code as needed.
5. If module fields are deleted or an error occurs, click Regenerate [source language] translations to restore missing data. This action doesn't delete comments.

Edit a translated module

Customize the translated version of a module for a specific language. 

1. In the finder, click the name of the module.
2. In the inspector, click the translation (e.g., Spanish - Mexico) in the Field translations section. 
3. Click into the code editor to add fields, comments, or other content to this translated version of the module.
4. If module fields are deleted or an error occurs, click Regenerate [translated language] translations to restore missing data. This action doesn't delete comments.
5. When finished, click Publish changes to publish your module translations.