The Smartling + Iterable integration lets you easily translate and localize your Iterable templates. Once you've set up the integration, you can start translation jobs from your Smartling account. The requested template is uploaded to Smartling, translated, then automatically imported to your Iterable project according to your project's locale settings.
Smartling supports email, SMS, in-app, and push templates.
Setup instructions
In Iterable
Step 1: Set up your locales
Before you set up the integration with Smartling, set up your project's locales.
Step 2: Create an API key
- Go to Integrations > API Keys.
- Click New API Key.
- Give your API key a name (for example, "Smartling Integration") and select Server-side.
- Click Create.
- Copy the API key to your clipboard.
IMPORTANT
Store your API key in a safe location. Once you close this menu, you won't be able to view the full API key again.
In Smartling
Step 1: Set up the Iterable Connector
-
Create a new Smartling project.
- Select the project type Connector.
- Select Iterable as the connecting platform.
- Select your desired source and target locales.
-
From the Settings tab in your Smartling project, click Iterable Settings > Connect to Iterable.
-
Enter the following credentials:
-
URL: The URL for the Iterable API for your region.
- If you have a USDC-based Iterable project, enter this URL: https://api.iterable.com
- If you have an EDC-based Iterable project, enter this URL: https://api.eu.iterable.com
- API Key: The "Smartling Integration" API key you created in Iterable.
- Source language. The default language for your Iterable project. You can find this in your Iterable project settings.
-
URL: The URL for the Iterable API for your region.
(Optional) Click Test Connection. If the connection is working, you should see a confirmation message.
Click Save Connection.
Step 2: Set up your language mappings
Next, you'll need to adjust a few settings to make sure the correct languages and locales are sent between Iterable and Smartling.
In your Smartling project, go to Project Settings > Iterable Settings.
-
In the Language Configuration section, you'll see the target languages that are set up for your Smartling project. Under Target Languages, enter the names of the locales you have set up in Iterable:
Click the check mark next to each target language to save your settings.
Step 3: Translate your Iterable content using Smartling
Once the Iterable Connector has been set up, you'll find Iterable templates in the Iterable tab of your Smartling project. From here, you can request and authorize content for translation and manage the translation process.
When translations are complete, the translated content is automatically sent to your Iterable project.
See Smartling's support article Translating with the Iterable Connector to learn more about translating your Iterable templates in Smartling.
IMPORTANT
It's not currently possible to translate Iterable templates via API if they were created with the Drag and Drop editor. (Doing so results in a mismatch between the JSON content that powers the Drag and Drop editor and the translated HTML content.) We recommend using either the WYSIWYG editor or Side by Side editor to create the templates you plan to translate with this integration.
If you use the Drag and Drop editor to build your Iterable templates, you'll need to convert these templates to HTML before translating them. To do this, export the HTML from any templates you’ve created with the Drag and Drop editor, and upload the HTML content to a new Iterable template. This creates an HTML template in the WYSIWYG or Side by Side editor. Select this template for translation in Smartling.
Questions?
To learn more about this integration, see Smartling's support article Iterable Connector Overview.
For additional questions or if you need help setting up this integration, reach out to your Iterable customer success manager.