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

# Managing translations for agentic workflows

After you configure target locales in your agentic workflow, export translatable text to CSV files, add translations, and import them back using CLI commands.

## Exporting translations

Export translatable text from an agentic workflow to a CSV file:

```bash Bash theme={null}
orchestrate tools translation-export \
  -k flow \
  --name my_flow_name \
  --translation translations.csv
```

You can also export from an agentic workflow JSON file before importing:

```bash Bash theme={null}
orchestrate tools translation-export \
  -k flow \
  -f path/to/flowJson.json \
  --translation translations.csv
```

<Expandable title="command flags">
  <ResponseField name="--kind (-k)" type="string" required>
    Must be `flow` for translation operations.
  </ResponseField>

  <ResponseField name="--name (-n)" type="string">
    Name of an imported agentic workflow tool. Required if you do not provide `--file`.
  </ResponseField>

  <ResponseField name="--file (-f)" type="string">
    Path to an agentic workflow JSON file. Required if you do not provide `--name`.
  </ResponseField>

  <ResponseField name="--translation" type="string" required>
    Path where the system saves the translation CSV file.
  </ResponseField>
</Expandable>

## Creating translations

The exported CSV file contains:

* `key`: Unique identifier for each translatable text element
* `en`: Source language text or your configured source locale
* `locale`: Source locale code
* Additional columns for each target locale

Edit the CSV file and add translations for each target locale:

```csv theme={null}
key,en,locale,fr,es
form.instructions,Please fill out this form,en,Veuillez remplir ce formulaire,Por favor complete este formulario
form.submit_button,Submit,en,Soumettre,Enviar
form.cancel_button,Cancel,en,Annuler,Cancelar
field.name.label,Your Name,en,Votre nom,Su nombre
field.name.placeholder,Enter your full name,en,Entrez votre nom complet,Ingrese su nombre completo
user_activity.user_name.display_name,Enter your name,en,Entrez votre nom,Ingrese su nombre
user_activity.user_name.help_text,Please provide your full name,en,Veuillez fournir votre nom complet,Por favor proporcione su nombre completo
```

<Note>
  Ensure your CSV file uses UTF-8 encoding to properly handle special characters in different languages.
</Note>

## Importing translations

Import translations from a CSV file into an agentic workflow:

```bash Bash theme={null}
orchestrate tools translation-import \
  -k flow \
  --name my_flow_name \
  --translation translations.csv
```

<Expandable title="command flags">
  | Flag            | Type   | Required | Description                                 |
  | --------------- | ------ | -------- | ------------------------------------------- |
  | `--kind` (`-k`) | string | Yes      | Must be `flow` for translation operations.  |
  | `--name` (`-n`) | string | Yes      | Name of the imported agentic workflow tool. |
  | `--translation` | string | Yes      | Path to the translation CSV file to import. |
</Expandable>

### Importing agentic workflows with translations

Import an agentic workflow and its translations in a single command:

```bash Bash theme={null}
orchestrate tools import \
  -k flow \
  -f path/to/my_flow.py \
  --translation translations.csv
```

This command imports the agentic workflow and applies the translations automatically.