This article is for Account Owners and Project Managers.
The Smartling HubSpot connector allows you to translate HubSpot content in Smartling. Translations are requested from within the Smartling platform, and translated content is automatically sent to your HubSpot instance.
The connector supports translation of emails, forms, landing pages, blogs, and web pages.
Prerequisites
To request a landing page or web page for translation, the Page language field must be set. If this field is empty, the page cannot be sent for translation and will display a failed status in Smartling with the error:Can’t send for translation. Language is not specified for page ID=‘exampleID’
To set the page language:
- Navigate to the page's Settings menu in HubSpot.
- Locate the Page language field.
- Select the source language from the dropdown menu.
Once the page language is set, you can request the page for translation in Smartling.
Request Translation in Smartling
Once you have linked your HubSpot account, your HubSpot content will appear in the Hubspot tab of your Smartling project. From here, you can choose which content to translate.
There are two ways in which you can request translation:
-
Select asset > Actions > Request Translation.
This option allows you to bulk-select multiple assets for translation.
-
Click the name of an asset > Request Translation.
This option allows you to request translation for a single asset.
Both methods will open a modal where you can select the languages you want to translate into.
Please continue to the section below to learn about the job creation process.
Important notes on job creation
The HubSpot Connector behaves differently from most other hosted connectors in how it handles job creation.
If the Auto-Authorize Daily Jobs setting is enabled for your account, the content will be automatically batched into a job named using the format: Daily Upload YYYY-MM-DD. The content will be authorized into the default workflow for each target language. If a daily upload job already exists for the current day, any additional content requested will be added to that existing job.
If the Auto-Authorize Daily Jobs setting is disabled, the content will not be batched into a job or authorized for translation. Instead, you will need to manually add the content to a job via the Strings View actions menu. To locate the content:
- From the Hubspot tab, find the asset you requested for translation and click its name to open the Asset Details page. Click the name of the target locale to open the content in the Strings View.
- Select all strings (using Select all matching current filter) > Actions > Request Translation. In the modal that appears, create a new job or add the content to an existing job.
- Finally, navigate to the job and authorize it for translation either from the project-level Jobs Dashboard or from the job details page.
Requesting Pages for Translation
In 2024, the HubSpot Connector was updated to support HubSpot's Pages API v3. Previously, with API v2, both Landing Pages and Website Pages were requested under the asset type Page. In the new version, assets should be requested via the new Landing Page or Website Page options. We highly recommend using these new asset types for all new translation requests to avoid issues as HubSpot phases out API v2. All new HubSpot Connector projects will list only the new asset types.
Please ensure you have completed the Locale Mapping and any custom Content Parsing settings for these new asset types under the project's Settings > HubSpot Settings.
If you've previously translated a Page, but have since updated the source content, you should re-request the asset for translation using one of the new asset types. Only the updated content will be translated, so any unchanged content will not require re-translation.
Check Status of Translations
The status of your HubSpot translation requests can be tracked in the Hubspot Progress tab:
- From within your Smartling Hubspot Project, click on gear icon > Hubspot Progress.
- Translation progress is indicated by a colored bar—purple means the content is still in progress, while green indicates that translation is complete.
Download Translations to HubSpot
Once translation is completed for a given asset, they are automatically sent back to your HubSpot instance.
To initiate a manual download of translated content to HubSpot:
- From within your Smartling HubSpot project, click on gear icon > Hubspot Progress.
- Select individual items using the checkbox next to the item name. Select all items from the list by using the checkbox next to the Title field.
- Click Export to HubSpot.
You can find your translated content in your HubSpot instance. The locale code will be appended to the translated asset.