HubSpot is an all-in-one platform that combines marketing, sales, and service tools to help businesses grow. With the Lokalise app, you can easily translate key types of content on HubSpot, ensuring your website and communications are ready for global audiences. The app supports the following content types:
Website pages
Landing pages
Emails
Blogs
However, please note that custom modules are not supported.
Managing HubSpot content
To manage your HubSpot content, navigate through the Marketing and Content dropdowns. As mentioned, 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 through Lokalise.
Go to Marketing > Marketing email and click Create email.
Adjust your email template. To change the default language, go to the Settings tab.
Choose your desired language from the dropdown menu.
Keep in mind that while you can clone an email in HubSpot, Lokalise only syncs the original (primary) emails. Cloned emails are not supported.
Lokalise also supports syncing emails that use A/B testing, but only version A will be imported since version B is considered a clone.
Landing and website pages
To create landing and website pages, follow the usual steps using the HubSpot wizard. You can set the page language by clicking the Settings button and selecting your desired language from the Language dropdown:
Blogs
When creating a blog, go to Settings and adjust 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 your content, there's an important step to take. Lokalise can't sync languages that don't have any content on your HubSpot site or blog—these are called "empty" languages.
To work around this, you'll need to create at least one page or blog post for each language you'd like to translate. For emails, only one version in your main language is required, and no additional locales need to be added for localizing emails. Let’s break it down further.
Imagine you’re setting up a project on HubSpot and want to translate content into English, French, and German:
Start by setting English as your main language and create some pages in English.
Add English, French, and German to your Lokalise project and import the English content from HubSpot.
After translating the content into French and German on Lokalise, you're ready to sync it back to HubSpot. However, you'll only be able to select English at this point, because French and German pages don’t exist yet on HubSpot.
To resolve this:
Open HubSpot.
Create a basic version of your pages in French and German. These don’t need to be fully translated right away.
Return to Lokalise.
Refresh the list of items to sync the latest changes, allowing you to sync all languages properly.
Website and landing pages
Once a page is created, follow these steps to add multi-language variations:
Click the More button 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. You must create at least one variation per language. For example, if you're translating into English, French, and German, you'll need to create at least one variation for each language.
Blog
When creating a new blog post:
Choose the post’s language from the Settings.
Click Add a language in settings to manage your blog languages.
Add new languages:
When creating a new blog post, you’ll be able to select a language variation.
Alternatively, you can click the More button next to an existing blog entry and choose Create multi-language variation.
Then, select the desired language from the dropdown and create your new variation.
Setting up the app
To get started with the HubSpot app in Lokalise, follow these steps:
Open your Web and mobile project in Lokalise and click on Apps.
Find HubSpot in the list and click on it.
In the dialog box, click Install.
You’ll be redirected to the HubSpot authorization page. Allow Lokalise to access 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 appear immediately, click Reload list to refresh the view.
You can use the Filter dropdown to narrow down your content. To re-sync at any time, click the Refresh button. After doing so, you'll see a confirmation message.
Importing content from HubSpot to Lokalise
The HubSpot app supports automated imports, which you can explore further in the Automated import/export article.
To translate HubSpot content, you'll need to import it into Lokalise. Tick the checkboxes next to the items you want to import, then click Import selected.
You'll see the following options in the dialog box:
Languages – choose one or more languages to import. If you've previously imported these items and want to get the latest versions, tick the Overwrite updated translations checkbox. Keep in mind, this will replace the corresponding translations in your Lokalise project with the new versions from HubSpot.
Skip key creation for empty translations – if enabled, Lokalise won’t create translation keys for any items that don’t contain content.
Assign tags – optionally, you can add custom tags to the imported translation keys by filling out this field.
Automations – if your project has automations enabled, you can apply your rules to the imported content.
Once you're ready, click OK. The import process will run in the background, and you’ll receive a notification once it's complete.
Managing translations
To manage your translations, return to the project editor by clicking on the project name in the top-left corner. Here, you’ll see all the content that was imported:
At this point, you can start translating your content as usual.
Tags
Each translation key may have several tags, represented by colored ellipses (including any custom tags you assigned during the import). These tags can be used to filter your translations.
To filter by tags, click Filter > Tag and select the tags you're interested in.
Exporting content from Lokalise to HubSpot
The HubSpot app supports automated exports, which you can explore further in the Automated import/export article.
Once your content is translated, you’ll need to export it back to HubSpot. Here’s how to do it:
Go to Apps and open the HubSpot app.
Select the items you want to export by ticking the checkboxes, then click Export selected.
Next, you’ll be prompted to:
Choose the languages you want to export. If a language is missing from the dropdown, make sure you’ve created a multi-language variation for it in HubSpot (as explained in the Managing HubSpot content section). This step only needs to be done once per language.
If necessary, uncheck the Don’t export empty translations option. Once you’re ready, click OK. The export process will run in the background, and you’ll receive a notification when it's finished.
Checking the result
Once the export is complete, return to HubSpot to review your translated content:
For emails, a separate email will be created for each language.
For pages and blogs, multi-language variations will appear under the "base" item. For example, if the primary language is English, you’ll also see a French variation if it was translated.
Known issues and limitations
Custom modules: Our app does not support custom modules in HubSpot. These modules won’t synchronize, but no errors will appear during import/export.
Cloned emails: Lokalise does not support synchronizing cloned emails—only the original (primary) emails are 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 make changes to published content in HubSpot, ensure you update the item. Unpublished changes won’t be recognized by the API and won’t sync correctly.
Draft content: For draft content, modify the default text in added modules. If not changed, the API won’t recognize the default text, and it won’t sync.
Video embeds: HubSpot uses oEmbed for embedding videos, 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.