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

# Translations

> Store custom product names and descriptions per subscription for multilingual customers

Translation overrides let you save custom product names and descriptions directly on a subscription. Once enabled, future catalog edits won't affect that customer's invoices.

Without overrides, Hyperline uses catalog translations when available, or falls back to the main product field.

## Set a default for all subscriptions

<Frame>
  <img src="https://mintcdn.com/hyperline/rPuSxS21I7OvCtNr/images/subscriptions/translations/settings-toggle.png?fit=max&auto=format&n=rPuSxS21I7OvCtNr&q=85&s=265217b7dbf2fc8e5a219cccd8aef5b8" width="3600" height="2080" data-path="images/subscriptions/translations/settings-toggle.png" />
</Frame>

Go to **Settings → Subscriptions** and enable **Override product translations on subscriptions**. New products added to any subscription will have the override on by default. Existing subscriptions are unaffected.

## Enable per product

<Frame>
  <img src="https://mintcdn.com/hyperline/rPuSxS21I7OvCtNr/images/subscriptions/translations/product-toggle.png?fit=max&auto=format&n=rPuSxS21I7OvCtNr&q=85&s=6d7dcc705afd6e45f4b951ae24bd1b86" width="3600" height="2168" data-path="images/subscriptions/translations/product-toggle.png" />
</Frame>

When creating or editing a subscription, scroll to the bottom of any product and toggle on **Override product translations**. A globe icon appears on the name and description fields.

<Note>
  The toggle only appears when the customer has a language set that differs from the invoicing entity's language. When both are the same, the main field already covers the only relevant locale.
</Note>

## Edit translations

<Frame>
  <img src="https://mintcdn.com/hyperline/rPuSxS21I7OvCtNr/images/subscriptions/translations/globe-panel.png?fit=max&auto=format&n=rPuSxS21I7OvCtNr&q=85&s=1eadab2bf64f9b2917624cd99ab728db" width="3600" height="2158" data-path="images/subscriptions/translations/globe-panel.png" />
</Frame>

Click the globe icon to open the translation panel. It shows one tab per language, limited to the customer's and invoicing entity's languages. The **Current** tab (customer's language) stays in sync with the main field automatically.

## Templates

<Frame>
  <img src="https://mintcdn.com/hyperline/rPuSxS21I7OvCtNr/images/subscriptions/translations/template-globe-panel.png?fit=max&auto=format&n=rPuSxS21I7OvCtNr&q=85&s=3af6837d69b8a172562f4250be587e02" width="3600" height="2082" data-path="images/subscriptions/translations/template-globe-panel.png" />
</Frame>

Templates show all available languages in the translation panel since no customer is attached. When assigned to a customer, the stored values carry over and the customer's language is marked **Current**.

## Precedence

From lowest to highest: **default** (`false`) → **subscription settings** → **template** → **subscription product**. A higher-level value always wins.

## FAQ

<AccordionGroup>
  <Accordion title="I turned off the override, what happens to my custom translations?">
    Hyperline reverts to catalog translations (or the main field if none exist). Your custom values are preserved on the subscription and restored if you re-enable the override.
  </Accordion>

  <Accordion title="Why is the toggle missing on a product?">
    Either the customer has no language set, or the customer and invoicing entity share the same language, in which case no separate translation tab is needed.
  </Accordion>

  <Accordion title="Can I override translations on invoice line items?">
    Yes. The same globe icon appears on name and description fields when editing an invoice manually.
  </Accordion>
</AccordionGroup>