> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mainwp.com/llms.txt
> Use this file to discover all available pages before exploring further.

# MainWP Assistant

> Ask documentation questions and work with your Child Sites using a connected ChatGPT plan or an AI provider API key in MainWP Dashboard 6.5 and later.

MainWP Assistant is a chat panel available in MainWP Dashboard 6.5 and later. It has two modes:

* **Docs** answers questions about MainWP from the official MainWP documentation. It doesn't need an AI key.
* **Sites** works with your own Child Sites through your connected ChatGPT plan or an AI provider API key. It starts read-only and, by default, asks you to confirm each change.

![MainWP Assistant panel open on the Clients page, showing the Home screen with Start Chat, Take a Tour, Watch Videos, and Community Forum cards](https://mintcdn.com/mainwp/PPci-6tEL3U1Kcf4/images/dashboard/mainwp-assistant-panel-home.jpg?fit=max\&auto=format\&n=PPci-6tEL3U1Kcf4\&q=85\&s=fec6fd621eb95c3a61c10daaae2f516f)

## What You'll Learn

* What Docs mode and Sites mode do and what each one needs
* Who can use the Assistant
* How to turn on the Assistant the first time
* How to open the Assistant from the sidebar, the Support modal, and the Command Palette
* How the panel is laid out

## Prerequisites

| | Docs mode | Sites mode |
| - | - | - |
| WordPress account | Administrator | Administrator |
| WordPress version on the Dashboard site | Any version MainWP Dashboard supports | WordPress 7.0 or later |
| AI connection | Not needed | Your own connected ChatGPT plan, or an AI provider with a working API key |
| Cost | No AI key or provider account needed | Your ChatGPT plan usage or your API provider account |

An administrator also has to accept the Assistant's privacy notice once before anyone on the Dashboard can chat. See [Turn on the Assistant](#turn-on-the-assistant).

> [!NOTE]
>
> The Assistant opens only for WordPress administrators who can access the Dashboard's **Overview**. If you use [Team Control](https://docs.mainwp.com/add-ons/agency/team-control-extension.md), turning the Assistant on, accepting the privacy notice, and changing Dashboard-wide Assistant settings also need the **Access MainWP Settings** permission.

## Docs Mode and Sites Mode

**Docs** sends your question to the MainWP documentation service and shows the answer with links to the documentation pages it used. It can't see or change your sites. Use it for "how do I" questions about MainWP.

**Sites** sends your request to your connected ChatGPT account or the AI provider configured in WordPress on your Dashboard site. The provider can call MainWP actions, such as listing sites, checking updates, or syncing sites, within the access you allow. Sites mode responses usually take 1 to 3 minutes.

What Sites mode can do depends on your access mode:

* **Read Only** (the default) lets it read data only.
* **Read & Write (with confirmation)** lets it make changes that don't delete anything, such as syncing sites or running updates. By default it asks you to confirm each one.
* **Full Access** also allows actions that delete or remove data. Those always show a preview and ask you to confirm.

See [Asking Questions](https://docs.mainwp.com/dashboard/mainwp-assistant/asking-questions.md) for confirmations and [Settings, Privacy, and History](https://docs.mainwp.com/dashboard/mainwp-assistant/settings-and-privacy.md) for access modes.

## Turn On the Assistant

On new installs the Assistant is turned on. After an upgrade, it keeps the setting of the earlier chat support option, which was off unless you turned it on. Turn it on from any of these places:

* **MainWP menu (three lines, top right) > MainWP Tools**, under **Privacy & Third-Party Services Permissions**: **MainWP Assistant (AI-Powered Chat Support)**
* The **Support Assistant** card in the [Support modal](https://docs.mainwp.com/getting-started/mainwp-support-modal.md)
* **Assistant Settings > AI Access Policies > Global Assistant Toggle** (`/wp-admin/admin.php?page=AssistantSettings&tab=policies`)

The first time someone opens a chat, the **Enable Assistant Features** dialog lists how the Assistant handles your data. Nothing goes to the documentation service or an AI provider until an administrator accepts it.

**1. Open a chat**

Open the Assistant and select **Start Chat**.

**2. Review the privacy notice**

Read the list in the **Enable Assistant Features** dialog.

**3. Accept**

Click **Enable & Continue**. The chat opens.

![Enable Assistant Features dialog listing how conversations are stored and where chat requests are sent, with Cancel and Enable & Continue buttons](https://mintcdn.com/mainwp/PPci-6tEL3U1Kcf4/images/dashboard/mainwp-assistant-consent.jpg?fit=max\&auto=format\&n=PPci-6tEL3U1Kcf4\&q=85\&s=2cbe7f4a7d3bee76c7416b2b8a809ffd)

Accepting applies to the whole Dashboard. If your account can't accept it, the Assistant shows "Assistant features are off. Ask a dashboard administrator to enable them."

## Open the Assistant

The Assistant panel is available on MainWP Dashboard pages. Open it in any of these ways:

* **Sidebar:** Click **Assistant** (robot icon) in the left navigation.
* **Support modal:** Click **Support** at the bottom of the left navigation, then click **Open Support Assistant** on the **Support Assistant** card. The modal closes and the chat opens.
* **Command Palette:** Press **Command + K** on Mac or **Ctrl + K** on Windows and Linux.
  * Choose **Open the MainWP Assistant** to open the chat.
  * Or type a question of two or more characters and choose **Ask the MainWP Assistant: *your text***. The chat opens with your text in the message box. It isn't sent until you click **Send message** or press **Enter**, so you can edit it or switch modes first.

![Command Palette with the text "restore a backup to a different site" and the result Ask the MainWP Assistant: restore a backup to a different site](https://mintcdn.com/mainwp/PPci-6tEL3U1Kcf4/images/dashboard/mainwp-assistant-command-palette-ask.jpg?fit=max\&auto=format\&n=PPci-6tEL3U1Kcf4\&q=85\&s=f85ea83b9ad39b1572416d7dd023dc2a)

The Ask result appears below any matching sites and clients. See [MainWP Command Palette](https://docs.mainwp.com/dashboard/overview/mainwp-command-palette.md) for the rest of the palette.

## The Panel

The panel opens in the bottom-right corner. Drag its header to move it, drag a corner to resize it, or use the header buttons:

| Button | What it does |
| - | - |
| **New Chat** | Starts a new conversation |
| **Insights** | Opens Dashboard Insights, where the Assistant widgets are. Shown when you can access Insights and the Logs module is on. |
| **Minimize** | Collapses the panel |
| **Maximize** / **Restore** | Expands the panel to fill the window, or returns it to its normal size |
| **Close assistant panel** | Closes the panel |

The tab bar at the bottom has four entries:

* **Home**: shortcut cards (**Start Chat**, **Take a Tour**, **Watch Videos**, **Community Forum**) and your most recent conversation. **Take a Tour** and **Watch Videos** work when guided tours and video tutorials are turned on and the current page has one.
* **Messages**: your saved conversations.
* **Contact support**: a form that sends your question to MainWP Support. See [Contact MainWP Support](https://docs.mainwp.com/dashboard/mainwp-assistant/contact-support.md).
* **Settings**: opens the **Assistant Settings** page.

## Related Resources

* [Asking Questions](https://docs.mainwp.com/dashboard/mainwp-assistant/asking-questions.md) - Docs and Sites modes, confirmations, and saved conversations
* [Contact MainWP Support](https://docs.mainwp.com/dashboard/mainwp-assistant/contact-support.md) - Send a conversation to MainWP Support
* [Settings, Privacy, and History](https://docs.mainwp.com/dashboard/mainwp-assistant/settings-and-privacy.md) - AI connection, access modes, what is sent where, and history
* [Troubleshooting](https://docs.mainwp.com/dashboard/mainwp-assistant/troubleshooting.md) - Messages you may see and how to fix them
* [MainWP AI Menu](https://docs.mainwp.com/dashboard/overview/mainwp-ai.md) - Knowledge, MainWP MCP, and MainWP Control


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.