# 在 Confluence Cloud 中配置 Live Search 宏的搜索范围
## 摘要
本文介绍如何在 Confluence Cloud 页面或实时文档（Live Doc）中插入 Live Search 宏，并通过参数设置限定搜索结果仅显示特定空间或带有特定标签的内容。
## 正文
在 Confluence Cloud 中，Live Search 宏允许用户在页面上添加一个搜索框。当用户输入关键词时，系统会动态显示匹配的搜索结果。为了更精准地控制搜索范围，管理员或内容创作者可以通过配置宏的参数来限制搜索来源。
### 插入与编辑宏
要添加 Live Search 宏，请在编辑模式下选择工具栏中的该宏，或通过输入斜杠命令（如 `/`）并键入宏名称进行查找。选中宏占位符后，点击编辑图标即可打开配置面板。参数设置支持实时保存，调整完成后即可继续编辑页面。
### 限制搜索范围：空间与标签
Live Search 宏提供了两个核心参数用于限定搜索结果的范围：
1. **Restrict to this Space Key（限制为此空间键）**
- **默认值**：all spaces（所有空间）
- **设置方法**：输入具体的空间键（spaceKey），该操作区分大小写。若希望仅搜索当前所在空间，可使用特殊值 `@self`。
2. **Restrict to label(s)（限制为标签）**
- **默认值**：""（空，即不限制）
- **设置方法**：输入一个或多个标签名称。若留空，则搜索所有内容，无论其是否带有标签。
通过组合使用这两个参数，您可以构建出仅针对特定空间内、且带有特定标签内容的精准搜索入口。此外，宏还支持调整字段大小（Size）、设置占位符文本（Placeholder text）以及选择包含的内容类型（Type），以满足不同的展示需求。