> 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/advanced-basic/quick-phrase.md).

# Quick Phrases

Quick Phrase is a set of**preset conversation templates**that can be invoked with one click from the shortcut menu in the chat box, avoiding repeated prompt input.

The phrases are divided into two types:

* **Global phrases**can be invoked in any assistant/chat
* **Assistant phrases**: take effect only under the assistant they belong to, suitable for pairing a specific role with a dedicated template

### Add Quick Phrase

Open `Settings → Quick Phrase`:

<figure><img src="/files/1bfbf593277552e3af09ef84ee3076c99817fc4c" alt=""><figcaption><p>Quick Phrase management panel</p></figcaption></figure>

1. Click the **+** button in the top-right corner of the page (hover to show the "Add phrase" tooltip)
2. Fill in:
   * **Title**: the name shown in the invocation menu (e.g., "Translate to English", "Code review")
   * **Content**: the text actually inserted into the chat box, **supports variables**(see below)
   * **Location for adding**: choose `Global phrases` or a specific assistant
3. Save

### Variables in content:`${name}` Syntax

Quick phrases support**user-defined variables**, with syntax `${variable name}`. After invoking the phrase, press <kbd>Tab</kbd> to quickly jump between multiple variable positions and fill them in.

Example:

```
Help me plan a route from ${出发地} to ${目的地}, and send it to ${邮箱}.
```

When invoking this phrase:

1. The content will be inserted into the chat box, and the cursor will automatically land at `${出发地}`
2. type "Shanghai", press <kbd>Tab</kbd> to jump to `${目的地}`
3. type "Hangzhou", press <kbd>Tab</kbd> to jump to `${邮箱}`
4. After filling in the address, press Enter to send

Variable names can be anything (Chinese or English). Variables with the same name will stay synchronized when filled.

{% hint style="info" %}
**The difference from "assistant prompt variables"**: assistants / Cherry Agent's**System Prompt**support another set of**predefined variables**that supports the Anthropic protocol (such as `{{date}}`、`{{time}}`、`{{model_name}}`、`{{username}}` etc.), which are automatically replaced by Cherry Studio at runtime. The two mechanisms are independent:

* `${name}`: used only for quick phrases,**user-defined**, manually filled at runtime
* `{{date}}` etc.: used only for assistant / Agent system prompts,**automatically replaced by the system**
  {% endhint %}

### Using in the chat box

* in [chat interface](/docs/en-us/cherry-studio/preview/chat.md) Click the ⚡ **Quick phrases** icon in the input toolbar, or type `/` in the input box to bring up the slash menu
* Choose the target phrase → the content is automatically inserted into the current input box, with the cursor staying on the first variable
* Press <kbd>Tab</kbd> to jump to the next variable

### Sorting and editing

* Drag list items to adjust the order
* Click a phrase item to edit or delete (deleted items cannot be restored)

### Tips and tricks

* Write a **“Review the following code, summarize in three columns: severity / type / fix suggestion:`${code}`”**, then paste the code into `${code}` to use it
* and [Text Selection Assistant](/docs/en-us/cherry-studio/preview/selection-assistant.md) Complementary: the selection assistant handles "selected content", while quick phrases provide "general-purpose templates"
* Multiple phrases can form your "prompt engineering library"; it is recommended to name them by scenario categories

***

### 💡 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/advanced-basic/quick-phrase.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.