Assistant customization controls how Ask AI appears on your published docs site. It does not change what the assistant can answer from.
Use dashboard Settings when you want no-code controls. Use docs.json when you
are configuring the site from source files.
What you can customize
| Setting | What it controls |
|---|---|
| Button | The floating Ask AI launcher button |
| Navbar button | An optional Ask AI entry in the top navigation |
| Heading | The heading shown inside the assistant panel |
| Suggested questions | Up to three starting prompts shown before a conversation begins |
| Icon | A local image used for the assistant icon |
Configure in docs.json
Add an assistant object to docs.json:
Suggested questions
Suggested questions should sound like real reader questions. They work best when they point to high-value workflows or common moments of uncertainty.
Use questions like:
- How do I publish a dashboard edit?
- How do I add a page to navigation?
- How do I configure Ask AI?
Avoid vague prompts like:
- Tell me about the docs.
- What can you do?
- Read more.
Assistant icon
Assistant icons must be local image files in your docs root. Use a path such as
/favicon.svg or /images/assistant.png.
Do not use an Iconify name or a remote URL for the assistant icon.
Button and color behavior
The assistant button uses your docs theme by default. Set a button color when the assistant needs to stand out from the rest of the page or match a specific brand treatment.
button.size can be default or small.