The search box at the top of the Design workspace’s left panel does two jobs. As you type, it filters the section’s list by name — instantly, as it always has. In three sections it can also search what your pages say, so you can find a page by a sentence you remember rather than by where it sits in a menu.
Where content search is available
| Section | Searches | Never returns |
|---|---|---|
| Site | Your posts page types, such as a blog, articles or landing pages | Documentation, API or internal pages |
| Documentation | Your documentation and API sets | Site or internal pages |
| Internal | Your internal page types | Site, documentation or API pages |
Each section searches only its own pages. Menus, Forms, Email templates and Assets filter by name only.
Running a search
- Pick Site, Documentation or Internal in the section picker.
- Type at least two characters. The list filters by name as usual, and a row reading Search content for “…” appears above it.
- Press Enter, or click that row.
The list is replaced by up to twenty matching pages. Each result shows the page title, its path — for an internal page, without the internal/ prefix and beside the internal icon — and a short excerpt. Click a result to open the page in the editor.
To go back to the list, close the results with ×, or just keep typing: any change to the query returns to the instant name filter. The × inside the search box clears it in one click without leaving the box. Switching sections clears both the query and the results.
Text and Semantic
A toggle at the top of the results picks how pages are matched.
| Mode | Finds | Use it for |
|---|---|---|
| Text (default) | Pages containing your words | Product names, error messages, a phrase you remember |
| Semantic | Pages about what you typed, even when they use different words | Questions and concepts — “how do refunds work”, “what to do when the build fails” |
The excerpt under a Text result is the passage that matched; under a Semantic result it is drawn from the page’s summary, and a page with no summary shows no excerpt. A good summary makes semantic results easier to scan.
What is searched
- Site and Documentation search your pages as they were last published. A draft that has never been published is not found yet; filter the list by name to find it.
- Internal searches each internal page as it stood when it was last locked, or when the last person editing it left the page. Edits made in the last few moments may not be searchable yet.
Results respect permissions: you never see a page you could not open. When nothing matches, the panel says No pages match “…”. If you lack access to search there, it says You don’t have access to search here., and any other failure says Search failed. Try again. — so an empty result list always means there were no matches.
Over MCP
AI clients have the same searches as tools: search_posts, search_documentation and search_api over published content, and search_internal over internal pages. See MCP Tools: Pages and Content.