Home / Glossary and context
Glossary and context

Say it once, and it holds everywhere

Two pieces of writing do most of the work in a localization project: a short brief describing the product, and a list of words that must never drift. Both are maintained per project and both reach every translator, human or machine.


Project context

The brief every translator reads first

A few lines describing the product, its audience and the constraints a translator would otherwise have to guess. Set per project, so a student banking brand and a private bank can share one key set and still sound nothing alike.

Project context

Free text, set per project. Different clients can have completely different tone instructions on the same key set.

“Casual and warm. Use du. This variant is for a student banking brand.”

Inherited by variants

A custom project starts with the default project's brief. Override it only when a client's tone genuinely differs.

Nordbank inherits the default brief. Caixa Verde sets its own.

Sent with every request

Because the brief travels with each string, length costs you on every key. Four useful lines beat four paragraphs of positioning.


Glossary

Glossary terms stay fixed across languages

Product names, regulated vocabulary, the word your CEO cares about. Lock it once per project and every locale obeys — AI and humans alike.

Glossary iOS app / Default · 34 terms Add term
Term
de-DE
fr-FR
pt-BR
Rule
Wallet
Konto
Portefeuille
Carteira
locked
React & i18next
React & i18next
React & i18next
React & i18next
do not translate
top up
aufladen
recharger
recarregar
locked
IBAN
IBAN
IBAN
IBAN
do not translate
statement
Kontoauszug
relevé
extrato
case-sensitive

Client variants inherit both

A custom project starts with the default project's glossary and brief. Most clients never need their own — the wording that differs is usually a handful of keys, not the whole vocabulary.

When one does, override just the terms that change. A white-label bank calling the wallet a Konto adds one term; everything else keeps reading through.

Default34 terms
iOS & SwiftUI1 override, 33 inherited
Android3 overrides, 31 inherited

Rules people can read too

The glossary is not only an AI input. A reviewer editing a cell sees the terms that apply to that string, with your preferred translation beside each one, so a human and a model reach the same answer.

A string that breaks a locked term is flagged in the grid whether a person or a model wrote it. Approving it anyway is allowed — with a note recorded on the revision.

Term honoured
Locked term missing — flagged, not blocked

Writing a brief

Four lines beat four paragraphs

The brief is sent with every request, so length costs you on every string. Say what the product is, who reads it, and the two or three constraints a translator would otherwise guess wrong.

Useful

Retail banking app for Germany. Address the user formally. Never translate Kestrel, IBAN or SEPA. Keep button labels under 20 characters.

Every clause changes an output. A translator could not have inferred any of it from the strings alone.

Wasted

We are a fast-growing fintech committed to delighting our customers with a seamless, best-in-class experience across all touchpoints.

Nothing here changes a single translation. It costs tokens on every key and dilutes the instructions that matter.

What belongs in the brief

The domain. Banking, healthcare, games — it changes vocabulary entirely.
Who reads it. Consumers, clinicians, internal staff.
Hard constraints. Character limits, words to leave in English.
House style. Sentence case, no exclamation marks, no idioms.

Register belongs on the language, not here — see formality.

Lock your product names before the first draft

Cheaper than correcting four thousand strings that all got it wrong the same way.

Start free AI translation