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

# Piece i18n

> Learn about translating pieces 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 piece

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

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

    <Tip>
      For open source pieces, you can use the [Crowdin project](https://crowdin.com/project/activepieces) 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](/build-pieces/building-pieces/development-setup), click the small cog icon next to the logo in your dashboard and change the locale.

    <img src="https://mintcdn.com/activepieces/ki8mFooo8mAmhMdP/resources/i18n-pieces.png?fit=max&auto=format&n=ki8mFooo8mAmhMdP&q=85&s=47b264ac0f3dd11a4ddac55c8b2d0cea" alt="Locales" width="317" height="615" data-path="resources/i18n-pieces.png" />

    <br />

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

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

  <Step title="Publish">
    Follow the docs here to [publish your piece](/build-pieces/sharing-pieces/overview)
  </Step>
</Steps>