> For the complete documentation index, see [llms.txt](https://help.brieftech.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.brieftech.ai/how-to-guides/review/translate-document-descriptions.md).

# Translate document descriptions

Translate document descriptions into Bahasa Malaysia, Chinese (Simplified), French, or English.

## Translate a single description

1. In the <img src="https://2262431129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlnHu06wl3NH457iwjBmr%2Fuploads%2Fgit-blob-8f18f06a78c4d0bf6e51eac54ec7d3e5d2cdb8a2%2Ftab-review.svg?alt=media" alt="Review tab" data-size="line"> tab, hover over the description cell of the document you want to translate — a row of action icons appears.
2. Click the <img src="https://2262431129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlnHu06wl3NH457iwjBmr%2Fuploads%2Fgit-blob-17c9d403849250e5f95b2b7fa28c719dd8d2ba70%2Ficon-translate.svg?alt=media" alt="translate" data-size="line"> translate icon.
3. In the dropdown that appears, select the target language.

The description updates immediately.

## Translate multiple descriptions at once

1. In the <img src="https://2262431129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlnHu06wl3NH457iwjBmr%2Fuploads%2Fgit-blob-8f18f06a78c4d0bf6e51eac54ec7d3e5d2cdb8a2%2Ftab-review.svg?alt=media" alt="Review tab" data-size="line"> tab, select the documents you want to translate using their checkboxes.
2. In the toolbar above the table, open the **Tools** menu and select <img src="https://2262431129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlnHu06wl3NH457iwjBmr%2Fuploads%2Fgit-blob-20cca8ba1ddb37b74ff6547b14b9cf50d7e7cb95%2Fbtn-translate-description.svg?alt=media" alt="Translate description…" data-size="line">.
3. In the dialog, select the target language from the list.
4. Click **Translate**.

BriefTech translates each selected description and reports how many were updated.

## After translating

The translated text is saved as a generated description. You can edit it manually at any time by double-clicking into the cell — once you save a change, the description is locked and marked as a manual override. To unlock the cell, hover over it and click the <img src="https://2262431129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlnHu06wl3NH457iwjBmr%2Fuploads%2Fgit-blob-b3e446d64b7bf9b7ecf24f801ef6b0e5046cfa99%2Ficon-lock.svg?alt=media" alt="lock" data-size="line"> lock icon: this keeps your current text and removes the padlock — it does **not** restore the translated text that was there before your edit.

There is no one-step revert to the description that existed before the translation. To restore the original AI-generated text, retype it manually or re-run the **Organise** agent on that document.

See [Document metadata fields](/reference/document-metadata-fields.md) for details on how generated values and locked overrides work.

## Related

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>How AI analysis works: agents and playbooks</strong></td><td>What agents and playbooks are, and what they extract.</td><td><a href="/concepts/how-ai-analysis-works.md">How AI analysis works: agents and playbooks</a></td></tr><tr><td><strong>Bulk-edit metadata across many documents</strong></td><td>Change labels, collections, dates, descriptions and index categories on many documents at once.</td><td><a href="/how-to-guides/review/bulk-edit-metadata.md">Bulk-edit metadata across many documents</a></td></tr><tr><td><strong>Document metadata fields</strong></td><td>The document fields you can edit in the Review tab and their accepted values.</td><td><a href="/reference/document-metadata-fields.md">Document metadata fields</a></td></tr><tr><td><strong>Review an AI-Analysed Matter</strong></td><td>A guided run through the Review stage — take a matter the AI has already analysed and confirm, correct, and refine its details until it's ready to index.</td><td><a href="/get-started/review-an-ai-analysed-matter.md">Review an AI-Analysed Matter</a></td></tr><tr><td><strong>Refine descriptions using your own edits as examples</strong></td><td>Edit a few descriptions the way you want them, then have BriefTech rewrite the rest to match.</td><td><a href="/how-to-guides/review/refine-descriptions-from-examples.md">Refine descriptions using your own edits as examples</a></td></tr></tbody></table>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://help.brieftech.ai/how-to-guides/review/translate-document-descriptions.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
