HubSpot is an all-in-one platform that combines marketing, sales, and service tools to help businesses grow. With the HubSpot for Lokalise app, you can easily translate key content types in HubSpot, ensuring your website and communications are ready for global audiences.
Supported content
The HubSpot app for Lokalise supports the following content types:
Website pages
Landing pages
Emails
Blogs
Custom modules are not supported.
Managing HubSpot content
To manage your HubSpot content, navigate through the Marketing and Content dropdowns. Lokalise allows you to translate landing pages, website pages, blogs, and emails.
If you're using a trial account on HubSpot, be aware that once the trial expires, access to content types like landing pages, blogs, and emails will be restricted. Only website pages will remain available for translation.
Go to Marketing > Marketing email and click Create email.
Adjust your email template as needed. To change the default language, open the Settings tab.
Choose your language from the dropdown menu.
Keep in mind that while HubSpot allows cloning emails, Lokalise only syncs the original (primary) emails. Cloned emails are not supported.
Lokalise also supports syncing A/B testing emails, but only version A will be imported, as version B is considered a clone.
Landing and website pages
To create landing and website pages, follow the standard steps using the HubSpot wizard. You can set the page language by clicking the Settings button and selecting your preferred language from the Language dropdown.
Blogs
When creating a blog, go to Settings and set the language under the Language & Region tab.
The language selected here will typically act as the base language for your Lokalise project.
Adding multi-language variations
Before translating, ensure that each language has at least one page or blog post on HubSpot. Lokalise cannot sync languages that have no existing content in HubSpot—these are considered empty languages.
For emails, only the main language version is needed, and no additional locales are required.
Example setup
If you're translating content into English, French, and German, follow these steps:
Set English as your main language and create pages in English.
Add English, French, and German to your Lokalise project and import English content from HubSpot.
Translate the content in Lokalise.
At this stage, you’ll only be able to sync English back to HubSpot since French and German pages don’t exist yet.
To resolve this, create basic pages in French and German in HubSpot. They don’t need to be fully translated yet.
Return to Lokalise and refresh the item list. This allows you to sync all languages properly.
Website and landing pages
Once a page is created, follow these steps to add multi-language variations:
Click More next to the page name and select Create multi-language variation from the dropdown.
Choose the primary language for your domain and click Save (this needs to be done only once).
Create the language variations. At least one variation per language must be created.
For example, if you’re translating into English, French, and German, you must create at least one page for each language.
Blog
When creating a new blog post, select the post’s language under Settings.
To manage blog languages, click Add a language in settings and add new languages. When creating a new blog post, you can choose a language variation.
Alternatively, you can click More next to an existing blog entry and select Create multi-language variation.
Then, choose the language from the dropdown and create the new variation.
Setting up the app
Creating Lokalise project
If you haven’t already, create a Marketing and support project on Lokalise.
Give it a name, select your base and target languages, and choose HubSpot from the Content integration dropdown.
Click Create project when you're ready.
Installing HubSpot app
You’ll be redirected to the HubSpot authorization page. Grant Lokalise access to your HubSpot account.
Lokalise will then perform an initial sync, and within a few seconds, your HubSpot content should appear.
If your content doesn’t load immediately, click Reload list to refresh the view.
Use the Filter dropdown to narrow down your content. To re-sync at any time, click Refresh. A confirmation message will appear once the sync is complete.
Importing content from HubSpot to Lokalise
The HubSpot app supports automated imports, which you can learn more about in the Automated import/export article.
To translate HubSpot content, first import it into Lokalise. Select the checkboxes next to the items you want to import, then click Import selected.
In the dialog box, you'll see the following options:
Import languages – choose one or more languages to import. If you've previously imported these items and want to update them, tick Overwrite updated translations. This will replace the existing translations in Lokalise with the latest versions from HubSpot.
Skip key creation for empty translations – if enabled, Lokalise won’t create translation keys for empty fields.
Assign tags – optionally, add custom tags to the imported translation keys.
Automations – if automations are enabled in your project, apply your rules to the imported content.
Once everything is set, click OK. The import will run in the background, and you’ll receive a notification when it's complete.
Managing translations
To manage your translations, go to the Editor by clicking on the project name in the top-left corner. Here, you'll see all the content that was imported. You can now start translating your content as usual.
Exporting content from Lokalise to HubSpot
The HubSpot app supports automated exports, which you can learn more about in the Automated import/export article.
Once your translations are ready, export them back to HubSpot.
Go to the Content management tab, select the items you want to export by ticking the checkboxes, and click Export selected.
In the export dialog, adjust the following options:
Choose the languages you want to export. If a language is missing, ensure a multi-language variation exists for it in HubSpot (as explained in the Managing HubSpot content section). This step is required only once per language.
Uncheck Don't export empty translations if you want to include untranslated content.
Click OK to start the export. The process will run in the background, and you’ll receive a notification when it’s complete.
Checking the result
Once the export is finished, return to HubSpot to review your translated content:
Emails – a separate email will be created for each language.
Pages and blogs – multi-language variations will appear under the base item. For example, if the primary language is English, a French variation will be available if translated.
Known issues and limitations
Custom modules – custom modules are not supported and won’t sync. However, no errors will be displayed during import/export.
Cloned emails – lokalise only syncs original (primary) emails. Cloned emails are not supported.
A/B testing – emails using A/B testing are supported, but only version A will be imported, as version B is considered a clone.
Published content updates – if you edit published content in HubSpot, ensure the item is updated before syncing. Unpublished changes won’t be recognized by the API.
Draft content – if a module contains default text that hasn’t been modified, the API won’t recognize it, and it won’t sync. Ensure that default text is manually updated.
Video embeds – HubSpot uses oEmbed for video embedding, but only approved sources from a JSON file are supported. For unsupported sources, use a custom module with an HTML iframe instead.
Note: Custom modules won’t sync with Lokalise and should not contain translatable content.