HubSpot is a marketing, sales, and service software. Lokalise app enables you to translate the following content types:
Website pages
Landing pages
E-mail
Blog
The app does not support smart content and custom modules.
Index
Preparing HubSpot content
To manage your HubSpot content, use the Marketing dropdown:
As already mentioned above, Lokalise enables you to translate Landing pages, Website pages, Blog, and E-mail.
Please note that if you have a trial HubSpot account, and your trial ends (which usually happens quite fast), you'll have access only to Website pages. All other content (landing pages, blogs, and e-mails) will be locked and you won't be able to translate these with Lokalise anymore.
Proceed to the Email page and click Create email:
Adjust your email template. To change the default language, open the Settings tab and choose a desired language from the corresponding dropdown:
While you can create an email's clone, Lokalise will not be able to synchronize those — in other words, Lokalise can only work with the "primary" emails, not with the clones.
Landing and website pages
Create your landing and website pages as usual using HubSpot wizard. You can choose page language under the Settings tab:
Blogs
During the first-time blog setup, you'll be asked to provide its name, URL, description, and, most important, the language:
Usually the language chosen here will also act as a base language in your Lokalise project.
Next, you can create blog pages as usual using HubSpot wizard.
Adding multi-language variations
This is a required step (even if you're translating only the emails) because due to technical limitations Lokalise will not be able to synchronize "empty" languages — the languages that don't have any content. Therefore, you'll need to create at least one page or a blog entry in each language that you would like to synchronize with Lokalise. However, you only need to create one email in your base language. You do not need to add locales to subscriptions for localizing emails. Here's the more detailed explanation:
Suppose, you create a new HubSpot project. You would like to translate your content into English, French, and German. You set English as a default language and create a handful of pages in English. Then, in your Lokalise project you add three languages: English, French, German. You import content from HubSpot, perform translations on Lokalise as usual, and then try to export this content back to HubSpot. However, at this point you will be able to choose only the English language because French and German are "empty" on HubSpot (in other words, they do not exist on HubSpot yet and Lokalise cannot synchronize those). Therefore, in order to fix this issue you have to return to HubSpot, create multi-language variations for French and German (you don't have to fully translate these variations though), then return to Lokalise and perform synchronization again.
Website and landing pages
After a page is created, click the More button next to its name:
Choose Create multi-language variation from the dropdown:
Choose the primary language for your domain and click Save (you'll have to do it only once):
Then you will need to create the actual variation. You must create at least one variation per language. For example, if your content should be translated into English, German, and French, you must create at least one language variation for every language:
Blog
When creating a new post, you'll be able to choose its language:
Click Add a language in settings to manage your blog languages.
Add new languages:
Now when creating a new blog post you'll be able to choose a new language variation:
Alternatively, you can click the More button next to the existing blog entry and choose Create multi-language variation:
Next choose a language from the dropdown and create your new variation.
Setting up the app
To get started with HubSpot app, proceed to Lokalise, open your project, and click Apps:
Find HubSpot in the list and click Install. Then click Connect:
Allow Lokalise to access your HubSpot account. Next, Lokalise will perform an initial synchronization, and after a couple of seconds you'll see your HubSpot content:
Use the Filter dropdown to filter the content further. To perform synchronization again, click the Refresh button. After clicking it, you'll see the following message.
Click the Reload list link to see the synchronized content.
Importing content from HubSpot to Lokalise
This app also supports automated import. You can learn more in the corresponding article.
To translate HubSpot content, you have to import it. To achieve that, tick the checkboxes next to the items and click Import selected. You'll be presented with the following dialog:
Choose one or more languages to import. If you have already imported the chosen items once and wish to download newer versions of the same items, then tick the Overwrite updated translations checkbox. Please note that this will overwrite all the corresponding translations in your Lokalise project with new versions from HubSpot.
You can also enable the Skip key creation for empty translations option which will not create any translation keys in your Lokalise project for translations that are empty.
Once you are ready, click OK. Your content will be imported to Lokalise in the background. After this process is finished, you’ll see a notification message.
Managing translations
Now return to the project editor by clicking on the project name in the top left corner. You will see all the imported content:
At this point you can perform translations as usual.
Tags
Each translation key has a handful of tags represented as colored ellipses:
HubSpot — this tag is assigned to every translation key exported from HubSpot.
Content type — this tag can have one of three values: "Email", "Landing page", or "Website page".
Item name — this tag is assigned based on the item that you have provided on HubSpot. For example, "Welcome email" is the name of the email template that was created on HubSpot.
You can use these tags to filter your translations. To achieve that, click Filter > Tag and choose the tags that you are interested in.
Exporting content from Lokalise to HubSpot
This app also supports automated export. You can learn more in the corresponding article.
Once you have translated the content, you’ll need to export it back to HubSpot. To achieve that, click Apps again and open the HubSpot app.
Find the items that you wish to export, tick the checkboxes next to them, and click Export selected:
Choose the languages that you would like to export:
If you don't see some language in the dropdown, make sure that you have created a multi-language variation for it on HubSpot as explained in this section. This operation has to be performed only once per language.
If needed, uncheck the Don’t export empty translations option. Once you are ready, click OK. Once the process is finished, you’ll see a notification message.
Checking the result
Once the export is finished, you can return to HubSpot and check your translated content.
Note, that translated content for Pages and Blogs will be displayed only in the published page version, you won’t be able to see updated texts in the page editor due to Hubspot limitations.
A separate email will be created for every language:
As for the pages and blogs, you'll be able to see multi-language variations under the "base" item. For example, this page has English set as the primary language, and also it was translated into French: