The working manual
What to press, in what order, and what to do when it misbehaves — from an empty app to a delivered .docx. Written to be kept open beside the app, not read once.
Before you start
Three things: the app installed, a Contextra account signed in (that is what activates your licence), and an AI provider key. Contextra runs on your own key by default, so you pay the provider directly and nothing you translate is metered by us. (Prefer not to manage a key? Managed AI credits — translation on Contextra's key, debited by tokens used — are live in your dashboard and arriving in the app through the beta channel first.)
You translate Word .docx files. The original is read on your machine and never modified — every export writes a new file.
Download and install Contextra, then start at step 1.
Step 1
Add your AI provider key
⌘, opens Settings. The first block is API keys — one card each for Google, Anthropic and OpenAI. Paste into the one you have an account with and press Save.
Save also checks the key against the provider, so a bad paste tells you now rather than at your first translation. One provider is enough; the rest can stay empty.
Settings
API keys and preferences are stored locally on this device.
API keys
Step 2
Set the two numbers
Still in Settings. Pick gemini-3.5-flash-lite under Default model — fast, strong on real documents, and a fraction of the cost of the flagship models. Move up later if a specific document argues for it.
Then, under Translation processing: Segments per batch 30, Parallel requests 4. A larger batch gives the model more of the document to stay consistent across; four at once keeps it quick without tripping rate limits.
The calendar button beside Date format is where you write date wording in your own words — always spell the month out in full; never abbreviate — sent with every translation, and settable per language.
Settings
API keys and preferences are stored locally on this device.
Default model
Provider
Model
Thinking level
Date format
Translation processing
Segments per batch
How many segments are sent to the LLM in one translation request.
Parallel requests
How many batches translate at once. Higher is faster but may hit provider rate limits.
Do this before you open documents. A change here is applied to every document already open, replacing what you had set on it. Defaults first, per-document overrides after.
Step 3
Add documents
Drag .docx files onto the dropzone or press Add documents (⌘O). Add as many as you like — each gets a row, and later its own tab.
Set source → target per row, and the provider and model if this document deserves different ones. The row is also where Formatting… hides the number and date options for that document alone.
The bar above works on the selection: tick several rows, set a language pair once and press Apply, then Analyze selected and Translate selected. Parallel there is a different setting from the one in Settings — it is how many documents run at once, not batches.
Drag .docx / .contextra files here, or
Step 4
Analyze
Press ⌘⇧A. The app reads the whole document, works out the domain and — for legal and civil papers — the jurisdiction, then learns the terminology and builds a glossary, checking your term base first so wording you have already approved wins.
You will see it pass through Reading the document, Understanding the context, Learning the terminology, and finish with an Analyzed chip. What it produced shows up as the glossary header: how many terms, the domain, the jurisdiction.
It is optional. Skipping it costs you the glossary, the domain steer for memory matching, and — if the source is still Auto-Detect — any memory reuse at all, because the language pair is only resolved here.
Glossary
7 terms · Legal · Spain
- Administrador S…DOC
→ joint and several admini…
In Spanish corporate law, ‘so…
- bolsa de horasDOC
→ hour pool
- organismo de c…DOC
→ authorized control body
Often abbreviated as OCA in …
- parte de trabajoDOC
→ service report
- caldera pirotubu…DOC
→ fire-tube boiler
- lucro cesanteDOC
→ lost profits
- concurso de acr…DOC
→ bankruptcy proceedings
Step 5
Translate
Press ⌘↵. Rows fill in as they finish, so you can start at the top while the bottom is still running. The same key stops it, and the button shows the count while it goes.
Memory answers first and the model second, so a document you have seen before is mostly filled before any request is made. A batch that fails — rate limit, dropped connection — marks those rows and lets the rest finish.
This is the screen you will live in: the glossary on the left, the grid in the middle, and on the right a live preview of the finished document plus the memory matches for the row you are on.
Glossary
7 terms · Legal · Spain
- Administrador S…DOC
→ joint and several admini…
In Spanish corporate law, ‘so…
- bolsa de horasDOC
→ hour pool
- organismo de c…DOC
→ authorized control body
Often abbreviated as OCA in …
- parte de trabajoDOC
→ service report
- caldera pirotubu…DOC
→ fire-tube boiler
- lucro cesanteDOC
→ lost profits
- concurso de acr…DOC
→ bankruptcy proceedings
Preview
TERMOVAL INGENIERÍA TÉRMICA, S.L.[TERMOVAL Logo]
INDUSTRIAL MAINTENANCE SERVICES AGREEMENT
Case File No. CTR-2025-0148
In Madrid, on 03/14/2025.
PARTIES
ON THE ONE HAND, MR. ALBERTO REYES MONTALBÁN, of legal age, of Spanish nationality, holder of National Identity Document No. 05.412.887-K, with address for these purposes at calle Bruselas no. 14, Polígono Industrial Las Mercedes, 28022 Madrid.
He acts in the name and on behalf of TERMOVAL INGENIERÍA TÉRMICA, S.L., a company of Spanish nationality, with registered office at the address indicated in the preceding paragraph, holding Tax Identification Number B-87654321, registered in the Mercantile Register of Madrid under volume 34,512, folio 118, sheet M-621,447, first entry. He holds the position of joint and several administrator, an office to which he was appointed for an indefinite term by virtue of a public deed granted before the Notary Public of Madrid, Mr. Ignacio Valdés Pereira, on February 9, 2021, under protocol number 412. Hereinafter, the “SERVICE PROVIDER”.
ON THE OTHER HAND, MS. CAROLINA IBÁÑEZ SUÁREZ, of legal age, of Spanish nationality, holder of National Identity Document No. 44.019.356-T, with address for these purposes at avenida de la Industria no. 205, 46940 Manises (Valencia).
She acts in the name and on behalf of ENVASES DEL LEVANTE, S.A.U., a
TM Matches
Select a segment to see its translation-memory matches.
Reviewed and accepted are different numbers. Opening a segment and moving on marks it reviewed. Accepting it (↵) also writes the pair into your translation memory. Plenty of translators read everything and accept only what they want their memory to learn — so the two counts diverge on purpose.
Step 6
Read the badges
Every filled row carries a badge saying where it came from. It is a statement about how much of your attention the row deserves, so it is worth knowing cold.
| Badge | What it means | What to do |
|---|---|---|
| 102% | Exact match from your memory, and the segments either side match too. | Trust it. This is the same sentence in the same place you translated before. |
| 101% | Exact match, with one neighbouring segment also matching. | Trust it, glance at it. |
| 100% | The source is exactly a pair you approved before, but the surrounding text differs. | Read it — an identical sentence can need different wording in a new place. |
| AI | Written by the model on this run, using the glossary and the document context. | Review it. This is where your attention belongs. |
| n% / Fuzzy | Close to something in memory, not identical. | Compare against the source diff in the TM Matches panel before accepting. |
Two more you will see: a ✓ once you accept a row, and a ⚠ when the call failed. A grey dot beside a badge means the row has been reviewed.
Step 7
Fix the terminology
Read the terms before the segments — a dozen decisions here settle hundreds of rows. Open a term from the glossary and press Analyze term when you want the full picture.
You get the meaning in this document, a definition with the local legal framing, the alternative translations each labelled with its register and what it is for, real usage examples with their sources, and a warning where the two systems do not line up. Press Use on the reading you want.
Saving re-translates the segments that term appears in, without you hunting for them.
parte de trabajo
→ service report
Meaning / notes
Standardization — recurring document issued and signed after each technician intervention to log hours and materials.
Definition
An official record or document detailing tasks performed, hours worked, or services rendered by an employee or contractor.
In Spanish legal and labor practice, a ‘parte de trabajo’ is an administrative or contractual document used to log work performed, hours spent, tasks completed, or operational incidents during a specific shift or project. It frequently serves as evidentiary proof in labor disputes…
specializedAlternative translations
Pick one to set it as this term’s translation.
- service reportFormal In use
When the document focuses on technical services, maintenance, or client-facing operations.
- work logNeutralUse
For documents tracking daily activities, tasks completed, and operational notes.
- daily activity reportVery FormalUse
In formal corporate, security, or field-service contexts where an employee details daily output.
- timesheetFormalUse
When the primary function of the ‘parte’ is to record hours worked for payroll purposes.
- work orderFormalUse
When the document acts as an authorization and subsequent completion record for specific assigned tasks.
Usage examples
“El trabajador deberá entregar el correspondiente parte de trabajo firmado al finalizar cada jornada laboral.”
Warnings
jurisdictionalGap — a ‘parte de trabajo’ often carries specific evidentiary weight in Spanish labor law (e.g. proving overtime or liability in workplace accidents) that does not have an exact equivalent institutional role in standard US common law employment documents.
Rows you already confirmed are left alone. A term edit never overwrites a segment you accepted, one filled from a 100–102% match, or one you typed. The glossary counts them and offers a Review link that selects exactly those rows, so you can redo them deliberately with ⌘⇧↵.
Step 8
Review the segments
One key does the work. ↵ accepts the row, copies it into every identical segment further down, records the pair in your memory, and moves to the next row that still needs you. Held down, it walks the document.
⌘1–⌘9 take a match from the TM panel, which shows the source difference so you can see what changed. ⌘⇧C copies the source across for rows that should not be translated at all — reference numbers, names, codes.
Filter the grid when you want one kind of work: only untranslated, only rows you have not looked at, or only the ones needing attention (failed, flagged, or waiting on a term edit).
Step 9
Merge and unmerge
Word breaks sentences where language does not — a heading split over two paragraphs, a sentence running through three table cells. Select the rows and press ⌘J to translate them as one unit. A ¶ tag marks where the break belongs; put it where it should fall and the export returns each part to its original paragraph.
It works across table cells, rows and whole tables, and the rows need not be adjacent — a phrase stacked down a column with unrelated cells between merges fine. ⌘T splits a row the other way.
And it comes back: ⌘⇧J unmerges to the original paragraphs, each with the translation and accepted state it had before. A dedicated action with a record of what was joined — not a general undo you have to reach in time.
- 1In the document
NOTARY ACKNOWLEDGMENT
The notary public certifies the authenticity of the
signature affixed to this document.
One sentence, split across a paragraph break.
- 2Merged in Contextra
EN · source
The notary public certifies the authenticity of the¶ signature affixed to this document.
ES · translation
El notario público certifica la autenticidad de la¶ firma estampada en este documento.
⌘/Ctrl+J joins them — position the ¶ where the break falls in the translation.
- 3On export
RECONOCIMIENTO NOTARIAL
El notario público certifica la autenticidad de la
firma estampada en este documento.
Redistributed to the same two paragraphs — no blank lines, structure untouched.
Unmerge restores what the rows held before the merge. A translation written on the merged unit is not divided back across them, so unmerging after translating a merged row means redoing it. Source edits are carried back correctly.
Step 10
Export
⌘⇧P opens Export view — not an impression of the output but the real bytes, with a toggle between the translation and the original. Check it there first.
⌘E writes the .docx: same layout, same tables, same bold and italics, new language. If segments are still untranslated the app says how many before writing, because those come out in the original wording.
⌘S is a different thing — it saves the project so you can close the app and pick the job up later. Trial exports are watermarked.
Every keyboard shortcut
The same list the app shows at ⌘/. Reviewing a thousand segments with a mouse costs a day, so it is worth taking ten minutes over this once.
Translate
- ⌘⇧A
- Analyze document
- ⌘↵
- Translate / Stop
- ⌘⇧↵
- Translate selected segments — re-does them whatever their status
- ↵
- Accept segment, propagate it, record it to memory, advance
- ⌘⇧C
- Copy source to translation
- ⌘1…9
- Use a memory match from the panel
- ⇧F3
- Cycle capitalisation — lower → Title → UPPER
Segments
- ⌘J
- Merge segments
- ⌘T
- Split segment…
- ⌘⇧J
- Unmerge / unsplit
- ↑ ↓
- Previous / next segment
- ⌘⇧↑ ⌘⇧↓
- Extend the selection up / down
- ⌘⇧E
- Edit the source text
View
- ⌘⇧D
- Switch dashboard / editor
- ⌘F
- Find in segments…
- ⌘⇧F
- Find and replace…
- ⌘⇧P
- Export view — preview the finished document
- ⌘⇧M
- Translation Memory & Term Base
- ⌘⇧U
- API usage
- ⌘/
- All keyboard shortcuts
File & window
- ⌘O
- Open…
- ⌘S
- Save a copy to disk (a .contextra project)
- ⌘E
- Export DOCX…
- ⌘,
- Settings…
- ⌘⇧W
- Close document
- ⌘⇧[ ⌘⇧]
- Previous / next tab
When something goes wrong
The handful of things that actually come up, and what each one means.
- Some segments came back failed
- A rate limit or a dropped call. Press Translate again — it only redoes what is missing. If it keeps happening, lower Parallel requests.
- Memory never matches anything
- The source language is still Auto-Detect. Memory cannot match until the pair is known: set it on the document row, or run Analyze, which resolves it.
- A term edit left some segments unchanged
- Rows you already accepted, filled from a 100–102% match, or typed yourself are protected. The glossary says how many and gives you a Review link that selects exactly those rows — then ⌘⇧↵.
- A provider shows “(no key)” and won’t select
- No key saved for it. Settings → API keys, paste, Save. Documents pinned to a keyless provider are moved to one that has a key.
- The exported file mixes both languages
- Untranslated segments export in their original wording. The warning before export tells you how many — fine for a draft, not for delivery.
- The export has a watermark
- Trial exports are watermarked. Activating a licence removes it; nothing else about the file changes.
- Settings changed a document I had already set up
- Editing Settings applies to every open document. Set your defaults before opening files, and override per document afterwards.