Audience: User
Tools → Overview is the project Tools workspace (eyebrow Workspace). Panel title Project tools — utilities for the selected project. Manage access is required to run actions.
This is not the AI assistant. For what the assistant can do for you, see AI Assistant.
| Role | Purpose |
|---|---|
| Project owner / Admin | Scan media, search & replace content, audit slugs, export a bundle |
| Author | Understand what Tools can change before asking an owner to run them |
Tools → Overview (side menu). Toolbar link Jobs opens the jobs list.
Subtitle when a project is selected: utilities for that project — manage access required. Without a project: Select a project to use tools.
📷 Project tools
Image Path:
images/tools-overview.png
Alt Text:
Tools page with Media health, Search & replace, Slug conflicts, and Project bundle
Caption:
Project tools overview.
One scan for unused media, missing files, and broken references. Unused is based on scanned surfaces only — confirm before purge.
Expected result: Counts and lists for unused / missing / broken refs. Deleting unused removes selected media records after confirmation.
Literal string replace in JSON string leaves. Preview is required before Apply.
| Control | Purpose |
|---|---|
| Scope checkboxes | Pages (draft), Published pages, Blocks, Data sources, Email templates |
| URL cleanup preset | Fills a common URL cleanup find/replace |
| Also update matching draft/working content | Shown when published pages are in scope |
| Find / Replace | Literal strings |
| Case sensitive | Match case |
| Preview / Apply | Preview hits, then apply with the preview token |
Warning
Published pages change the live site. Prefer keeping draft sync on when editing published content.
Expected result after Preview: Hit count and snippets. Apply writes replacements for the previewed set.
Empty, invalid, or duplicate working/published slugs (metadata only).
Download a project .tar archive.
| Layer | Rule |
|---|---|
| Menu | Signed-in users |
| Run tools | Must be able to manage the selected project (owner or Admin) |
| Problem | Cause | Solution |
|---|---|---|
| Controls disabled | No project / no manage access | Select a project you can manage |
| Apply disabled | No preview yet | Run Preview first |
| Confused with AI assistant | Different feature | See AI Assistant |