> ## Documentation Index
> Fetch the complete documentation index at: https://help.emaillove.com/llms.txt
> Use this file to discover all available pages before exploring further.

# How to Translate Braze Email Templates Using Smartling

> Design in Figma, export to Braze with auto-generated translation tags, and translate with Smartling

This guide shows you how to design an email in Figma, export it to Braze with translation tags automatically added, and translate it into multiple languages using Smartling.

## What You'll Need

Before you begin, make sure you have:

* Email Love Figma Plugin installed
* A Braze account with API access
* A Smartling account
* An email design ready in Figma

## Overview

This workflow eliminates the need to manually add Braze translation tags (`{% translation_tag %}`) to your emails. Instead, the Email Love Figma Plugin automatically wraps your text, URLs, and alt text in translation tags during export.

The complete process takes approximately 10 minutes.

<iframe width="100%" height="400" src="https://www.youtube.com/embed/80NoByWYxE0" title="How to Translate Braze Email Templates Using Smartling" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen />

<Steps>
  <Step title="Export Your Email from Figma">
    1. Open your email design in Figma
    2. Launch the Email Love Figma Plugin
    3. Select **Braze** from the ESP dropdown menu
    4. Check the following boxes:
       * **Add localization tags** (wraps all text in Braze translation tags)
       * **Add localization tags for URLs** (wraps links in translation tags)
    5. Click **Export to Braze**

    Your email will upload to Braze as a template with translation tags automatically added around all text, URLs, and alt text.
  </Step>

  <Step title="Create a Campaign in Braze">
    1. Log into your Braze account
    2. Navigate to the **Templates** section
    3. Locate your newly exported template
    4. Go to **Campaigns** and click **Create Campaign**
    5. Give your campaign a name
    6. Select **Email** as the message type
    7. Choose **Select from Template**
    8. Select the template you just exported from Figma
    9. You'll see your email code with translation tags already in place

    ### Add Your Target Languages

    Before saving, you need to tell Braze which languages you're translating into:

    1. In the campaign editor, locate the **Language** settings
    2. Select your target languages (e.g., English, French, German)
    3. Click **Save Draft**
  </Step>

  <Step title="Connect Smartling to Braze">
    If you haven't connected Smartling to Braze yet, follow these steps:

    ### In Braze

    1. Go to **Settings** → **APIs and Identifiers**
    2. Click **API Keys**
    3. Click **Create API Key**
    4. Give your API key a name (e.g., "Smartling Integration")
    5. Under permissions, check all boxes (or at minimum, template access)
       * *Note: While template access should theoretically be enough, checking all boxes ensures the integration works smoothly*
    6. Click **Create API Key**
    7. Copy your **API Identifier** (you'll need this in a moment)
    8. Note your **Endpoint URL** (also found in the API settings)

    ### In Smartling

    1. Go to **All Projects**
    2. Click **Create New Project**
    3. Give your project a name
    4. Select **Braze** as the connector type
    5. Choose your linguistic package
    6. Select your target languages (e.g., French, German)
    7. Click **Create Project**

    ### Configure the Braze Connection

    1. In your new Smartling project, go to **Settings**
    2. Navigate to **Braze Settings**
    3. Enter the following information:
       * **API Key**: Paste the API identifier you copied from Braze
       * **API URL**: Paste the endpoint URL from Braze
       * **Language Attribute**: `language` (same as the example in Smartling)
       * **Source Language**: English (or your default language)
    4. Choose your email preference:
       * **One email for all languages** (recommended)
       * **Separate email per language**
    5. Click **Test Connection**
    6. If successful, click **Save**
  </Step>

  <Step title="Request Translation in Smartling">
    1. In Smartling, click the **Braze** tab in the left sidebar
    2. You'll see a list of available templates and campaigns
    3. Navigate to the **Campaigns** section
    4. Locate the campaign you created in Step 2
    5. Check the box next to your campaign
    6. Click **Request Translation**
    7. Enter a job name
    8. Select your target languages
    9. Choose your translation method:
       * **AI Translation** (fastest, good for speed)
       * **Human Translation** (slower, best for quality)
    10. Click **Authorize Job**

    Smartling will extract all text from your email and begin translating. For AI translation, this typically takes just a few minutes.

    ### Optional: Translate URLs Manually

    If you need to translate URLs to language-specific landing pages:

    1. Click into the translation job
    2. Navigate to the URL fields
    3. Manually update each URL with the appropriate translated version
    4. Save your changes
  </Step>

  <Step title="Preview Your Translated Email">
    1. Return to Braze
    2. Go to your campaign
    3. Click **Preview Message**
    4. In the preview settings, select **Multi-language user**
    5. Choose a language from the dropdown (e.g., French, German)

    You should now see your email translated into the selected language with the same design and layout as your original.
  </Step>
</Steps>