Translate Liquid template files with Hyperlocalise

​

Source file

<h1>Welcome, {{ customer.first_name }}!</h1>
<p>Open your account to view your orders.</p>
{{ 'header.title' | t }}

​

Configure your files

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

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

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

​

Translate

hyperlocalise run --dry-run
hyperlocalise run

​

Behavior and limitations

• Translates hardcoded visible template text and protects Liquid output expressions.
• Locale-key calls such as the t filter remain template structure. Translate their backing locale files separately.
• raw, comment, schema, javascript, and stylesheet blocks are preserved verbatim.
• Standalone Liquid tags form segment boundaries. Template syntax is restored after translation.

​

Next steps

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

​

Related formats

• HTML
• JSON localization