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

Google key set
Replace key…SaveClear
Anthropicno key
Paste API keySave
OpenAIno key
Paste API keySave
Keys are stored on this device under the signed-in account — not uploaded to contextra.pro, and not shared between machines. You have to be signed in before the app has anywhere to file one.

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

Google

Model

gemini-3.5-flash-lite

Thinking level

Medium — balanced

Date format

Automatic

Translation processing

Segments per batch

How many segments are sent to the LLM in one translation request.

30

Parallel requests

How many batches translate at once. Higher is faster but may hit provider rate limits.

4
Saved on this device and applied to every document. Per-document overrides live in the Control Panel.
The Indexing section below has fields with the same two names. Those tune glossary matching during Analyze, not translation — change the ones under Translation processing.

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.

DocumentsTeamLibraryMemoryUsage

Drag .docx / .contextra files here, or

Add documents
Select all Analyze selectedTranslate selectedStop all
Auto-DetectEnglish (US)ApplyUse memoryParallel 2
DEMO ESEN 01 Contrato de Prestacion de Servici… Analyzed33/329 translated AnalyzeTranslate
Spanish (Spain)English (US)Googlegemini-3.5-flash-liteFormatting…
Segments are cut on import, so a document is split into rows before anything is translated — which is why the row can already say 33 of 329 translated. The chips are independent of each other: Analyze is optional, so a document can be translated without ever having been analyzed.

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

Add term Save to Term Base
  • 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

› Considered & skipped (3)
Analyze’s output, as you actually meet it: seven terms it judged worth pinning for a Spanish maintenance contract, each tagged DOC because it was found in this document — a term already in your term base arrives tagged TB instead. Below them, what it considered and skipped.

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.

Dashboard AnalyzeTranslate
DEMO ESEN 01 Contrat…
Search source or translation…
Source
Translation
1
TERMOVAL INGENIERÍA TÉRMICA, S.L.
AITERMOVAL INGENIERÍA TÉRMICA, S.L.
2
[Logotipo TERMOVAL]
AI[TERMOVAL Logo]
3
CONTRATO DE PRESTACIÓN DE SERVICIOS DE MANTENIMIENTO INDUSTRIAL
AIINDUSTRIAL MAINTENANCE SERVICES AGREEMENT
4
Expediente n.º CTR-2025-0148
AICase File No. CTR-2025-0148
5
En Madrid, a 14 de marzo de 2025.
AIIn Madrid, on 03/14/2025.
6
REUNIDOS
AIPARTIES
7
DE UNA PARTE, D. ALBERTO REYES MONTALBÁN, mayor de edad, de nacionalidad española, con Documento Nacional de Identidad n.º 05.412.887-K, y domicilio a estos efectos en calle Bruselas n.º 14, Polígono Industrial Las Mercedes, 28022 Madrid.
AION 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.
8
Interviene en nombre y representación de TERMOVAL INGENIERÍA TÉRMICA, S.L., sociedad de nacionalidad española, con domicilio social en el indicado en el párrafo anterior, provista de Número de Identificación Fiscal B-87654321, inscrita en el Registro Mercantil de Madrid al tomo 34.512, folio 118, hoja M-621.447, inscripción 1.ª. Ostenta la condición de Administrador Solidario, cargo para el que fue nombrado por tiempo indefinido en virtud de escritura pública otorgada ante el Notario de Madrid D. Ignacio Valdés Pereira el 9 de febrero de 2021, con el número 412 de su protocolo. En lo sucesivo, el «PRESTADOR».
AIHe 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”.
9
DE OTRA PARTE, D.ª CAROLINA IBÁÑEZ SUÁREZ, mayor de edad, de nacionalidad española, con Documento Nacional de Identidad n.º 44.019.356-T, y domicilio a estos efectos en avenida de la Industria n.º 205, 46940 Manises (Valencia).
AION 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).
0/329 reviewed · 0 accepted · 329 segments296 AI33 100↵ accept·⌘↑ ⌘↓ navigate·⌘/ all shortcuts
The status bar is the line worth learning: reviewed, accepted, the total, then a count per badge — here 296 written by the model and 33 filled from memory, which are this nine-page contract’s running heads and page markers repeating verbatim. Nothing is reviewed yet, so the first two numbers are still zero.

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.

BadgeWhat it meansWhat 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.
AIWritten by the model on this run, using the glossary and the document context.Review it. This is where your attention belongs.
n% / FuzzyClose 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.

Appears in 6 segments — jump to first Edit Delete

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…

specialized

Alternative 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.”

Convenio Colectivo del Sector de la Construcción de la Provincia de Valencia · standard

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.

Five defensible renderings of one term, separated by register and purpose — which is the actual decision a certified translator is making. “Appears in 6 segments — jump to first” takes you to every one of them.

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.

  1. 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.

  2. 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.

  3. 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.

Join the halves, translate them as one sentence, place the — the document's layout stays exactly the same.
Split in the file, one unit while you work, correct on the way out.

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. SettingsAPI 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.

Bring your next document into the AI era

Try the full app free for 14 days — and the memories, glossaries, and term bases you build are yours from day one.