Translation and Localization Resources | SimulTrans

Steps to Set Up Hubspot Connector

Written by Margarita Núñez | April 25, 2023

If you use HubSpot and need website or marketing content translated, SimulTrans can help.  We offer a seamless integration with your HubSpot instance through a dedicated connector. We use HubSpot and have lots of experience localizing content.

The connector allows content to be exported from HubSpot to a Translation Management System (TMS) for translation. The content is translated and reviewed. When the translation is complete, the connector imports the translated content into HubSpot while maintaining the structure and layout.  

Step 1. Connect 

Create a user account for SimulTrans on your HubSpot site.  This is a one-time setup to establish our connection. 

In your HubSpot instance, go to: Settings ⚙️> Users & Teams>Add Users>Create New 

Enter the email addresses that we will send to you,  and send. Click on Next

Choose how to set access: Choose Start from Scratch> Choose Permissions:

Pro tip: While we do not necessarily need all the access levels, plese make sure you enable the checkbox for: View, Edit, Publish, or Delete, to avoid getting connection errors. 

Marketing  

Select Marketing from the list on the left first. Switch ON permissions for the items you need SimulTrans to localize for you.  

  • Forms and Files 
  • Marketing Access
  • Marketing Tools: Ads, Campaigns, Marketing Email, CTA, SMS, Social, and Marketing Events
  • Website Tools:  Blog, Landing Pages, Website Pages, HubDB, URL redirects
  • Design Tools

Account

Navigate back to Account in the left panel.

In Setting Access, switch ON permissions for: 

  • App Marketplace Access
  • Template Marketplace Access
  • Edit Property Settings
  • HubDB Table Settings
  • Global Content and  Theme settings
  • Website settings

 In User & Account Access, switch ON permissions for:  

  • Account Access

  • Add an edit users, Add and edit teams, Presets, Edit account defaults

Partner program

If you are a HubSpot partner, navigate back to Partner program in the left panel. Switch ON permissions for:   

  • Partner client object

  • Partner tools
  • Partner dashboard, solutions directory

CRM

By default, when you assign an account, HubSpot enables all the CRM objects for that user.  Please ensure that you select "They own" and enable the checkbox " Unassigned" in Contacts.

Click Next. Review Permissions and click Send.

We will confirm once we get the invitation to join your HubSpot instance.

Pro tip: You can also assign SimulTrans as a Super Admin.

Step 2. Prepare Content for Translation

Review the copy and ensure it is free from errors and spelling mistakes.
Also, ensure that all filenames follow a clear and consistent internal page name.

Example: 

  • Good naming convention: Home 2026, Services 2026, About Us 2026, etc.
  • Bad naming convention: Home -new, Services 26, About -v2, etc. 

List all URLs for translation and email the list to us to receive an accurate quote.

The connector can export content from:

  • Landing pages
  • Website pages
  • Blog post
  • Forms
  • Themes (including menus, headers, footers, etc)
Other content, such as content in HubDB and CTA, needs to be exported manually.

HubSpot>Content> HubDB>Edit>Actions>Export

If your webpage has a Form, you need to list the form name as a separate item for translation.

Pro tip: If you have other resources that need translation, such as eBooks, case studies, white papers, checklists, and videos, these can be sent for translation separately.

Step 3. Confirm Language Settings

Confirm which is the primary language of your domain. You can find out which is yours here:

HubSpot>⚙️> Website>Domains & URLs>Language Settings.

Select what languages you need the website translated into and choose the appropriate language codes.

Example:
 
  • Spanish US, code (es-US)
  • French France, code (fr-FR)
 Confirm the "publish status" of the translated web pages: 
 
  • A publish status of "draft" (recommended) means the translated pages are ready for you to review and publish on your own schedule.
  • A publish status of "published" means that pages will be live once we import them.
Decide how you need your translated web pages saved in your HubSpot marketing platform.
 
  • As a multi-language group. This means the translated pages are linked to the master page and form a group.  It will be displayed like this on your HubSpot platform:

  • Or pages saved as a separate document. This means that the translated pages are stored as siblings, and the language code appended to their internal page name differentiates the individual translations. It will be displayed like this on your HubSpot platform:

Pro tip: If you plan to continue to update the website copy during translation, it is better to save the imported translated pages separately as a sibling. 

Step 4. Confirm URLs 

Confirm the URLs (web addresses) for the translated web pages.

Example:

Confirm whether you need the content slug translated or left in English.
 
Example of translated slug:

Example of slug left in English:

Note: It is best not to have extended characters such as á, ü, é, ó, à etc. in the URL:

Example

  • Incorrect: https://www.simultrans.com/de/website-übersetzung
  • Correct: https://www.simultrans.com/de/website-uebersetzung

These steps are needed only once. When you have the HubSpot site connected with SimulTrans, we can initiate translations whenever pages are updated, on a weekly or other regular (or sporadic) basis, or wait until you tell us it's time for an update. 

By default, the connector re-syncs the entire page in order to accommodate any potential layout changes. The use of Translation Memories allows us to only translate new or updated content.

Download our HubSpot Case Study and read more about key learnings from our own experience translating SimulTrans' HubSpot website.