> For the complete documentation index, see [llms.txt](https://docs.cherryai.com.cn/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.cherryai.com.cn/docs/en-us/cherry-studio/preview/translation.md).

# Translation

Cherry Studio's translation feature provides fast and accurate text translation services, supporting translation between multiple languages.

### Interface Overview

<figure><img src="/files/3157290e616c52a2e8b86099278d62f225804467" alt=""><figcaption><p>Translation page: input on the left, output on the right, with language and model switching at the top</p></figcaption></figure>

The action bar from left to right:

1. **Translation History**(FolderClock icon): Left drawer, review past translations and refill them with one click
2. **Source language dropdown**: Default `Auto-detect`, when auto-detection succeeds, the specific language will be shown in the options
3. **Direction switch**(⇆): Swap source / target languages
4. **Target language dropdown**
5. **Translate button**: grayed out when the input box is empty
6. **Model selection**(model avatar): switch the model used for translation
7. **Settings**: open the translation settings dialog

The input box (left) supports pasting text,**dragging in `.txt/.md` text files**, and **dragging in images for OCR** ; when you hover over the result box (right), a copy button appears.

### Usage Steps

1. **Select the target language**
2. **Enter or paste text** into the left box — dragging in images can be directly OCR-recognized and then translated
3. Click **Translation** button
4. Copy or continue editing the result on the right

### Translation Settings

Click the gear icon in the upper right to open the settings dialog:

<figure><img src="/files/51ca01be3860032d7bb586c4ae9c5810253dab0b" alt=""><figcaption><p>Translation Settings Dialog</p></figcaption></figure>

* **Markdown Preview**: when enabled, translation results are rendered as Markdown
* **Automatically copy after translation is complete**: copy the result to the clipboard as soon as it is generated
* **Scroll synchronization settings**: the left and right columns scroll in sync
* **Auto-detection method**: Auto / Algorithm (local franc) / LLM — LLM detection is more accurate but consumes one model call
* **Bidirectional translation settings**: when enabled, it will automatically translate between two specified languages; you can choose the language pair below
* **More settings**: jump to full translation preferences (default model / prompts / custom languages, etc.)

### Frequently Asked Questions (FAQ)

* **Q: What if the translation is inaccurate?**
  * A: AI translation is powerful, but not perfect. For texts in specialized fields or complex contexts, manual proofreading is recommended. You can also try switching to a different model.
* **Q: Which languages are supported?**
  * A: Cherry Studio's translation feature supports many mainstream languages. For the specific list of supported languages, please refer to the official Cherry Studio website or the in-app instructions.
* **Q: Can it translate an entire file / image?**
  * A: The input box supports direct**dragging in text files or images**, and images will be recognized by OCR before translation. For full-article translation of long documents (PDF / Word, etc.), it is recommended to go to the chat page and send the document as an attachment to the translation assistant for processing.
* **Q: What if the translation is slow?**
  * A: Translation speed may be affected by factors such as network connection, text length, and server load. Please make sure your network connection is stable and wait patiently.

***

### 💡 Get help and submit feedback

If you encounter any questions, bugs, or have suggestions for feature improvements during configuration or use, please refer to [Feedback and Suggestions](/docs/en-us/question-contact/suggestions.md) the official channels provided there.


---

# 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://docs.cherryai.com.cn/docs/en-us/cherry-studio/preview/translation.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.