Translate CSV localization files with Hyperlocalise

​

Source file

key,value
home.title,Welcome
home.greeting,"Hello, {name}!"

​

Configure your files

locales:
    source: en-US
    targets:
        - es-ES

buckets:
    messages:
        files:
            - from: locales/en-US/messages.csv
              to: locales/{{target}}/messages.csv

llm:
    profiles:
        default:
            provider: openai
            model: gpt-5.2

​

Translate

hyperlocalise run --dry-run
hyperlocalise run

​

Behavior and limitations

• The example uses a header row with key and value. CSV quoting handles commas and multiline values.
• Locale-column layouts are also supported. Source and target locales select the corresponding columns.
• Existing rows retain their order; newly appended keys are sorted. CSV quoting and line endings may be normalized.
• This page covers translation files. For status --output csv, see Command output.

​

Next steps

• Check translations before committing generated files.
• Local translation workflow explains repeat runs.
• Browse all file formats.

​

Related formats

• JSON localization
• gettext PO