Configure the assistant

Configure the AI assistant in your Mintlify dashboard: toggle availability, customize responses, add starter questions, set bot protection, and manage billing.

Configure the assistant on the Assistant page of your dashboard. Manage billing and usage on the Usage page.

Enable or disable the assistant

Toggle the assistant status to enable or disable the assistant for your documentation site.

Set deflection email

In the Response Handling section, enable the assistant to redirect unanswered questions to your support team.

Specify an email address for the assistant to give to users if it cannot answer their question. You can also enable a “Contact support” button to appear in the assistant chat panel.

Search domains

In the Response Handling section, configure domains that the assistant can use for web search to find additional context when answering questions.

• Domains must be publicly available.
• Domains that require JavaScript to load are not supported.

For more precise control over what the assistant can search, use filtering syntax.

• Domain-level filtering
  • example.com: Search only the example.com domain
  • docs.example.com: Search only the docs.example.com subdomain
  • *.example.com: Search all subdomains of example.com
• Path-level filtering
  • docs.example.com/api: Search all pages under the /api subpath
• Multiple patterns
  • Add multiple entries to target different sections of sites

Add sample questions

Help your users begin conversations with the assistant by adding starter questions. Starter questions appear in the assistant chat panel as one-click prompts.

The assistant can generate page-specific questions based on the page a user is viewing, or you can add persistent questions that are available across all pages.

• Contextual questions: Enable contextual starter questions to have the assistant automatically suggest questions tailored to the page a user is viewing.
• Persistent questions: Add up to three questions that appear on every page. Click Ask Assistant to get recommended questions based on your documentation, or write your own.

Persistent and contextual questions can be enabled together. When both are enabled, the assistant prioritizes contextual questions on pages where they are available.

Bot protection

In the Bot Protection section, enable invisible captcha to protect your assistant from automated abuse. The bot protection is privacy-friendly and invisible to nearly all visitors.

To enable bot protection:

1. Go to the Assistant settings page in your dashboard.
2. In the Bot Protection section, toggle Invisible Captcha on.

Changes take up to 10 minutes to propagate.

If you use custom Content Security Policy headers, you must include hcaptcha.com and *.hcaptcha.com in your allowlist.

Manage billing

The assistant runs on credits. Each assistant message consumes credits, where a message is any user interaction with the assistant that receives a response. See Credit pricing for more information.

Change your credit tier

1. Go to the Usage page of your dashboard.
2. In the Credit packages section, select a tier from the dropdown menu.
3. Confirm the change to proceed to checkout.

Allow overages

Overages are disabled by default. With overages disabled, the assistant is unavailable once you reach your credit allowance and remains unavailable until your allowance resets.

To allow overages, enable them in the Spending controls section of the Usage page of your dashboard. If you enable overages, each credit beyond your allowance incurs an overage charge.

Set usage alerts

In the Spending controls section of your dashboard, set usage alerts to receive an email when you reach a certain percentage of your credit allowance.

Higher credit volumes

For plans larger than 10,000 credits per month, contact sales to discuss custom credit packages.