š§ŖBeta: The HubSpot Integration is currently in beta. Features and functionalities are subject to change. Thank you for your patience and feedback during this phase as we continue to improve the experience!
The HubSpot integration lets you synchronize your content and completed translations between HubSpot and Transifex. This integration allows your localization team to leverage most of Transifex's services while translating your HubSpot emails and blogs.
Configuring your HubSpot content to support multiple languages
HubSpot blogs must be configured to support multiple languages before integration is installed. To do so, first, log in to your HubSpot account, and then:
Navigate to the left sidebar Content > Blog
Hover over the blog you want to add a language variation, click on More
Click on Create multi-language variation
Select a target language from the drop-down list, and
Click on Create
You need to create as many language variations as the target languages added in your Transifex project.
For HubSpot emails, you don't have to add language variations prior to installing the integration. The integration will create new email templates based on their translations, with the same name and language code added at the end.
Installing the HubSpot integration
š” Tip: To connect your HubSpot and Transifex accounts, you must be a Transifex project maintainer or administrator.
Follow the steps described below to connect your HubSpot and Transifex accounts:
Navigate to āhttps://app.transifex.com/ā
Log in to your Transifex account. This will take you to the Transifex Dashboard.
Go to your project Settings > Integrations > HubSpot > Install (change this screenshot)
You will be redirected to the integrationās authorization page, where:
First, it is necessary to grant permission for the integration to perform modifications in Transifex on your behalf.
ā
Next, you must authorize the integration in your HubSpot account. To do this, log into HubSpot with your credentials (if you haven't already done so).
If you have connected more than one account to your HubSpot credentials, you need to select one of them and Click on Choose Account.
Click on the Connect app. You are now ready to import HubSpot content.
Managing your HubSpot content
From the Project settings, move to the Integrations tab and click on theĀ Manage ContentĀ button to view localizable content. Search across blogs and emails whose source language matches the project's source language.
When you identify HubSpot content you want to sync with your Transifex project, mark it by checking the box on the left of its title.
Any selections you have made are persistent, so you can keep searching and navigating on the displayed content list without losing your selections.
You can learn more about the search functionality by checking the respective section below toĀ choose content for translation.
When you are done selecting your content for the first time, click Next. You will now define how the syncing between Transifex and HubSpot will happen (more details are available here).
When you finish this setup step, click the Save & Close button to sync content from HubSpot to Transifex.
š Note: Some of the steps described above are also accessible when updating the integration settings. For more, check theĀ Synching content from HubSpot to TransifexĀ andĀ Editing synchronization settingsĀ sections below.
Choosing content for translation
In this subsection, we expand on the full functionality provided when you click onĀ the Manage ContentĀ button any time but the first time you install the integration.
For each blog or email in the list, you can see some additional information depending on the sync status for that content:
If the content is selected to sync between HubSpot and Transifex, it is checked; otherwise, it is unchecked.
The Title of the Blog or Email.
The Content-Type that each item is based on
The content Status in HubSpot
The Last HubSpot update field holds the date of the last update of the content in HubSpot.
Filtering content
To filter the content displayed in the list, choose the drop-down to select the content type and type in the search box:
The content list can be filtered by pressing the Search button.
The search will look at blogs and email Titles (depending on the selected content type).
To clear out a search term, delete it and press the Search button (alternatively, you can use the X icon in the search area.)
Items in the list have pagination.
You can change the page size using the drop-down displayed under the content list and navigate through the different pages using the left and right arrows located in the same area under the content list.
Editing synchronization settings
Importing source content options
Fetch Initial Blog Translations from HubSpot
All HubSpot blogs synced for the first time with Transifex will also sync any existing translations into the newly created resource as long as the option "Fetch Initial Blog Translations from HubSpot" is enabled.
If the option is unchecked, we always ignore translations found on HubSpot and never send them to Transifex.
If the option is checked, it works as follows:
Every time content is synced from HubSpot to Transifex, the integration checks each resource/language separately and:
If the language for this resource is empty (there are zero translations), we take the translated content from HubSpot and send it to Transifex.
If, on the other hand, there is even one translation on Transifex for this resource/language, we consider Transifex to be the source of truth, so we ignore the HubSpot translations for that resource/language and do not send them to Transifex.
This includes content detected during the integration setup or new content detected on a subsequent sync.
Any syncing actions on content with a resource in Transifex will not include translations updated on HubSpot.
If any translations are present in Transifex's resources, Transifex is considered the source of truth, and any translations in HubSpot will be ignored.
A relevant warning should be displayed for the specific task in the activity logs.
Exporting localized content options
Syncing localized content back to HubSpot can work automatically per blog or email template in each target language. The integration offers three possible options for automatically sending localized content back to HubSpot:
100% translated or updated (for 100% translated)
100% reviewed or updated (for 100% reviewed)
100% proofread or updated (for 100% proofread)
Depending on the setting selection, this will apply to individual Blogs or Emails as they are localized in each target language. For example, once a Blog is fully translated into French, the French entry will be sent to HubSpot. If the Īlog's Chinese translation is not fully translated, it will not be sent to HubSpot.
All the sync options are triggered when the language reaches 100%. This means that if, for example, an already reviewed language is edited, the updated reviewed translation will be sent to HubSpot automatically.
Translating content in Transifex
Each Blog or Email synced from HubSpot to Transifex will create a FILELESS resource following the HubSpot title name. For example, if you have two blog entries in HubSpot titled āWhat Iāve learned so farā and āFew tips for installing the appā, syncing them to Transifex via the integration, you will get two resources with the same names:
āWhat Iāve learned so farā
āFew tips for installing the appā
The fields that will form the resource for Emails and Blogs in each Transifex resource are the following:
For Blogs
Blog name
Blog title
Blog's meta description
Blog's post body
For Emails
Email title
Email subject
Email text
Email preview text
Once your content is inside Transifex, you can start translating it or manage the localization process as appropriate.
š Important Note for new Emails from Hubspot: Please make sure to press
the save button when you create a new email and not rely only on the autosave functionality in order to correctly sync all new edited content to Transifex.
Syncing manually content from HubSpot to Transifex
You can manually import content from HubSpot anytime: syncing content from HubSpot to Transifex happens upon saving or updating the integration settings in the Īntegrationās UI (Project Settings ā Integrations ā HubSpotā Manage).
When a syncing process is initiated, you will be able to see that syncing is in progress in the activity log. This process could take some time, depending on the number and size of the syncing files.
If you want to add new content for synchronization or remove existing content, click Manage Content in the project integrationās UI to show the Content Search screen. Check all the new content you want to sync. Then click the Save & Sync button to start a new sync process.
Syncing manually content from Transifex to HubSpot
There is an option to send localized content to HubSpot manually without waiting for a resource to be 100% translated or reviewed (Project Settings ā Integrations ā HubSpotā Manage ā (ellipsis) Manual Sync).
By clicking on Manual Sync, a modal will appear requesting the threshold localization percentage that Transifex will check on all your project's resources.
All target languages localized above that threshold will be synced with HubSpot using the Sync content options you have set up for the integration.
For example, suppose you had set up HubSpot to sync 100% translated resources. In that case, the manual process will identify all target languages whose translation percentage is equal to or above the threshold percentage you set on the modal and sync all content back to HubSpot.
š Note: Syncing less than 100% translated content to HubSpot might result in parts of the content being in the resource's original language. This issue will be eliminated when that content is fully translated into Transifex and synced back to HubSpot.
Activity log
To check the synchronization results, either from Transifex to HubSpot or from HubSpot to Transifex, you must load the integrationās UI, where all events that happened are logged in chronological order (the most recent ones appear first).
These logs allow you to identify any potential issues with particular Blogs or Emails that failed to sync. Go to your project settings > Īntegrations tab, and click the Manage link under the HubSpot section to load the integrationās UI.
Uninstalling the HubSpot integration
To uninstall the HubSpot integration from your project, you have to follow the steps below:
Go to your project settings > integrations, click on the ellipsis, and select Remove integration.
Click on Remove to confirm the action.
š”Tip
Looking for more help? Get support from our Transifex Community Forum!
Find answers or post to get help from Transifex Support and our Community.