---
title: Customize the assistant
description: Configure the assistant button, navbar button, heading, suggested questions, and icon.
---

Assistant customization controls how Knowledge Assistant 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 assistant launcher button |
| Navbar button | An optional assistant 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`:

```json
{
  "assistant": {
    "heading": "Ask Radiant Docs",
    "questions": [
      "How do I publish a docs change?",
      "How do I add an API reference?",
      "How do I connect a custom domain?"
    ],
    "button": {
      "size": "default",
      "color": "#171717"
    },
    "navbarButton": {
      "enabled": true,
      "text": "Ask"
    },
    "icon": {
      "src": "/favicon.svg"
    }
  }
}
```

## 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 Knowledge Assistant?

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`.

## Related pages

<Columns columns={3}>
  <Column>

  <Card title="Add context sources" href="/knowledge-assistant/add-context-sources" icon="lucide:database-zap">
    Expand assistant context.
  </Card>

  </Column>
  <Column>

  <Card title="docs.json overview" href="/configure-with-docs-json/overview" icon="lucide:file-json-2">
    Configure from source.
  </Card>

  </Column>
  <Column>

  <Card title="Settings" href="/edit-in-dashboard/settings" icon="lucide:settings">
    Configure without code.
  </Card>

  </Column>
</Columns>