# Translate & Localize Your Advocate Program

The Advocate platform uses participant-specific locale information to help you translate and localize your referral program’s content and rewards. These locales (e.g. `en_GB`, `nl_NL`) are a combination of a two-letter language code and a two-letter country code, as defined in ISO 639-1 and ISO 3166-1 alpha-2, respectively. You can send impact.com locale information for individual participants whenever you send us customer advocate and event details.

#### Translate and localize your program content

{% stepper %}
{% step %}

#### Step 1: Download the source copy and messaging

1. In the left navigation menu, select ![](https://4048883401-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-230534471fef5f40808e921e41ee44e4a06ded03%2Fe6cb9548999afdc1ed3ce4942e4cb5b45b5cecbd323267aac2a7cd1915fccc09.svg?alt=media) **\[Engage]** → **Program Rules**.
2. On the *Program Rules* screen, select the **Content** tab.

   <div data-with-frame="true"><figure><img src="https://4048883401-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-ba3db2e3c90ae3f89cf451f55f2d871c7fadb1dc%2F84a83ea5547cf360db5fa353d5b63cacf22e3bfd06e328bc748e932cfa40c280.jpg?alt=media" alt="" width="322"><figcaption></figcaption></figure></div>
3. In the *Translations* section, select **Edit** → **Download Source** or **Download Source and Translations**.

   <div data-with-frame="true"><figure><img src="https://4048883401-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-690f44bfbfb8606cba5480ba507c00d1a956b475%2F73c36fb82e1b8834bb28ca9a3add67adf52509d78b8d53ad9df314ad6bdea403.jpg?alt=media" alt="" width="563"><figcaption></figcaption></figure></div>

{% hint style="warning" %}
**Important:** There is an alternative method to download translations. This method is the only way to handle translations for microsite content.
{% endhint %}

1. In the left navigation menu, select **Content**.
2. In the *Translations* section select **Microsite** to expand a list of options, then select the microsite content you want to translate.
3. Select to **Download Source** or **Download Source and Translations**.

The provided zip file will include your default and any translated copy (if present) in the following format:

<div data-with-frame="true"><figure><img src="https://4048883401-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-7ff823ea175517ae51bd01797786a5ee09bcfc6d%2Fd32fc2a1a82174e541e2204cd0d7874f6ab5fe8054f39ed7b353868a853fbad3.png?alt=media" alt="" width="321"><figcaption></figcaption></figure></div>

In this example, the `programEmailID.json`, `programWidgetID.json`, `referredReward.json` or `referrerReward.json` files contain the default copy for the program's email, widget, and rewards.
{% endstep %}

{% step %}

#### Step 2: Translate the source files

Use a copy of the default email or widget messaging (found in the `programEmailID.json` or `programWidgetID.json` files) as the basis for your translations, and a copy of the default reward settings as the template for your localized reward types and amounts.

If you have previously made translations they will be included in the download, in the folder of the widget/email they are for (e.g. /`programEmailID`) with the file name of the locale they are for (e.g. `nl_NL.json`).

You can choose to make edits to the existing translations/rewards you have, for a specific locale, or delete the existing content and start fresh from the default file.
{% endstep %}

{% step %}

#### Step 3: Package the translations

1. Place your translated files back into the folder of the same name as the source file you translated (*e.g.* the `/signupRewardEmail` folder for the translations of `signupRewardEmail.json`).

   The following example shows translations for the `fr_FR` and `en_US` locales having been placed in the folder for the program's email `/programEmailID`, widget `/programWidgetID`, and rewards `/referredReward` and `/referrerReward`.

   <div data-with-frame="true"><figure><img src="https://4048883401-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-ebd7a87da34175b48a511fcf3e16b304e5bcf964%2Fa8d26aad2fb3b3aedb2f1c2f4120df0b332776e9320fc1745e40f2e0fc9c19a7.png?alt=media" alt="" width="563"><figcaption></figcaption></figure></div>
2. Create a zip of the folder containing the `/Emails` and `/Widgets` folders.
   {% endstep %}

{% step %}

#### Step 4: Upload the translations

1. Upload the zipped folder in the *Translations* section of the **Contents** tab on the *Program Rules* page or *Content* page, depending on the method you used in *Step 1*.
2. Select **Done** and confirm that the file was uploaded successfully.

Congratulations! Your referral program is now localized.
{% endstep %}
{% endstepper %}