# 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 ![](/files/CDnwOBeIdds9r3Z6zTnO) **\[Engage]** → **Program Rules**.
2. On the *Program Rules* screen, select the **Content** tab.

   <div data-with-frame="true"><figure><img src="/files/vSiNpdGCyWHwEm9S81a8" 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="/files/qpXMOntJoepKsQvGVaST" 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="/files/59M7jcsHhBFMeIspltOY" 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="/files/jqA8BG4FEEbBxvL4vT0z" 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 %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.impact.com/brand/what-would-you-like-to-learn-about/advocate-program/advocate-program-settings/translate-and-localize-your-advocate-program.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.