DocsAI
Scopes and modes
Every AI request has a scope — what it may change — and a mode — how far it goes. Together they keep “make this bolder” from redesigning the whole page.
Scopes#
| Scope | The request may change | Available |
|---|---|---|
| Selected element | The selection | When something is selected |
| Current section | The section around the selection | When something is selected |
| Current page | The page you’re editing | On pages |
| Current template | The template you’re editing | When a template is open |
| Global component | The Global Block you’re editing | When a Global Block is open |
| Entire site | Anything on the site, at the level that fits — see Site-wide changes | Always |
Automatic (the default) follows what you’re looking at: with a heading selected, “make this bolder” changes the heading; with nothing selected, it works on the page. If you pick a scope that doesn’t apply any more, the request falls back to automatic.
Modes#
| Mode | What it does |
|---|---|
| Edit | Changes what you point at. |
| Refactor | Improves structure and consistency — cleaner nesting, shared classes, tokens instead of one-off values — keeping the content and layout. |
| Redesign | Significant visual changes, keeping content and site structure. Proposes a plan first. |
| Generate | Creates new pages, sections or components. |
Examples#
| Request | Scope and mode |
|---|---|
| “Make this heading shorter and punchier” | Selected element · Edit |
| “Tidy up this page’s spacing and use our classes” | Current page · Refactor |
| “Give the whole site a warmer, more editorial look” | Entire site · Redesign |
| “Add an FAQ page answering these questions: …” | Entire site · Generate |
Related articles
Still have a question? Email us at support.