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

# Addon i18n

> Learn about translating addons to multiple locales

<Steps>
  <Step title="Generate">
    Run the following command to create a translation file with all the strings that need translation in your addon

    ```bash theme={null}
    npm run cli addons generate-translation-file PIECE_FOLDER_NAME
    ```
  </Step>

  <Step title="Translate">
    Make a copy of `packages/addons/<community_or_custom>/<your_addon>/src/i18n/translation.json`, name it `<locale>.json` i.e fr.json and translate the values.

    <Tip>
      For open source addons, you can use the [Crowdin project](https://crowdin.com/project/NRAI) to translate to different languages. These translations will automatically sync back to your code.
    </Tip>
  </Step>

  <Step title="Test Locally">
    After following the steps to [setup your development environment](/developers/development-setup/getting-started), click the small cog icon next to the logo in your dashboard and change the locale.

    <img src="https://mintlify.s3.us-west-1.amazonaws.com/newratantechnologiespvtltd/resources/i18n-addons.png" alt="Locales" />

    <br />

    In the builder your addon will now appear in the translated language:

    <img src="https://mintcdn.com/newratantechnologiespvtltd/spalPXI-HIltx4rW/resources/french-webhooks.png?fit=max&auto=format&n=spalPXI-HIltx4rW&q=85&s=77714f227a3a723aca2eada804bbc430" alt="French Webhooks" width="567" height="845" data-path="resources/french-webhooks.png" />
  </Step>

  <Step title="Publish">
    Follow the docs here to [publish your addon](/developers/sharing-addons/overview)
  </Step>
</Steps>