Skip to content

Translate your custom CRM content

Last updated: October 24, 2025

Available with any of the following subscriptions, except where noted:

If your account's users work in multiple languages, you can create translations for your custom CRM data. You can create translations for custom properties, including custom pipelines, pipeline stage properties, custom association labels, and custom object labels.

Add translations for CRM data

Permissions required Super Admin or Custom data translations permissions are required to create and manage translations.

Please note: translations are not currently supported for line items.

To import translated data:
  1. In your HubSpot account, click the settings settings icon in the top navigation bar.
  2. In the left sidebar menu, under Data Management, navigate to Translations.
  3. If you're creating your first translation, click Add custom data translation. If you're adding an additional translation, click Add translation in the top right.
  4. In the dialog box, select the language you want to translate CRM data into, then click Add.
  5. In the green pop-up banner, click export the translation file for this language.
  6. In the dialog box, click Export.
  7. The exported file contains the type of data that can be translated, the status of the translation, the default text to be translated, and a reference key. In the file, add translations in the column of the corresponding translation language (e.g., French translation, Spanish translation, etc.).
    data-translation-file
  1. Once the file is ready, return to the Translations settings screen, hover over the language, then click Import.
  2. In the dialog box, click Choose a translation file, then click Import.
  3. Once the import is processed, to turn on the translation, hover over the language, then click Turn on.

A HubSpot settings panel for Translation. It shows the status for German as 'Off - Missing translations (1% translated)' with buttons for Export, Import, and Turn on.

Once turned on, translated data will be visible to users who use HubSpot in that language. For users editing property labels or options within HubSpot, translated values will not be visible.

Manage CRM data translations

One you've created translations, you can edit translated content, translate additional content as it becomes available, or turn off a language's translations.

To add, edit, or remove translations:

  1. In your HubSpot account, click the settings settings icon in the top navigation bar.
  2. In the left sidebar menu, under Data Management, navigate to Translations.
  3. Export the translation file. The file will contain values you previously imported, and empty cells for missing translations.
  4. Update the file depending on your goal:
    • To add new translations, add values in the empty cells of the language column.
    • To edit existing translations, update the values in the language column.
    • To remove existing translations, clear the values in the language column.
  5. Navigate back to the Translations settings, then import the file.

To turn off or on a translation:

  1. In your HubSpot account, click the settings settings icon in the top navigation bar.
  2. In the left sidebar menu, under Data Management, navigate to Translations.
  3. Hover over the language, then click Turn off. In the dialog box, click Turn off to confirm.
  4. Hover over the language, then click Turn on.

Turn on translation import and export notifications 

You can receive email or browser notifications for completed translation imports and exports.

  1. In your HubSpot account, click the settings settings icon in the top navigation bar.
  2. In the left sidebar menu, navigate to Notifications.
  3. Click the Email & Desktop tab.
  4. Toggle the switches on to receive email or desktop (e.g., Bell) notifications.
  5. To receive a notification when a translation import is completed, expand the CRM section, then select the Translations checkbox.
    A HubSpot notification settings screen with a search for "translat". The Translations setting is visible, showing that Bell and Email notifications are checked for import completion.
  6. To receive a notification when a translation export is completed, expand the System notifications section, then select the Export completed checkbox.
    A HubSpot notification settings screen with a search for "export compl". The Export completed notification is visible, showing Browser, Bell, and Email notifications are on.
  7. Click Save to confirm.

Learn more about setting up user notifications.

Was this article helpful?
This form is used for documentation feedback only. Learn how to get help with HubSpot.