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

# Ask Questions with MainWP Assistant

> Ask MainWP questions in Docs mode, work with your sites in Sites mode, switch between modes, confirm actions, and find, export, or delete saved conversations.

Type a question in the Assistant panel and choose the mode that fits it: **Docs** for questions about MainWP, **Sites** for work on your own child sites.

## What You'll Learn

* Ask a question in Docs mode and use the answer controls
* Switch to Sites mode and what happens when it isn't set up
* Confirm or cancel an action Sites mode wants to run
* Find, export, and delete saved conversations

## Prerequisites

* The Assistant is turned on and its privacy notice was accepted. See [Turn On the Assistant](https://docs.mainwp.com/dashboard/mainwp-assistant/overview.md#turn-on-the-assistant).
* For Sites mode: WordPress 7.0 or later on the Dashboard site and your own connected ChatGPT plan or an AI provider with a working API key. See [Connect an AI Provider](https://docs.mainwp.com/dashboard/mainwp-assistant/settings-and-privacy.md#connect-an-ai-provider).

## Ask a Question in Docs Mode

**1. Open the chat**

Open the Assistant and select **Start Chat**, or click **New Chat** in the panel header.

**2. Check the mode**

Next to **Mode:**, make sure **Docs** is selected. The line under it starts with "Answers from MainWP documentation."

**3. Ask**

Type your question in the box and press **Enter**, or click **Send message**. Press **Shift + Enter** for a new line. A message can be up to 2,000 characters.

**4. Read the answer**

The answer lists the documentation pages it used under **Sources:**. Click a source to open that page.

While an answer is being written, the send button changes to **Stop**. Click it to stop the response.

Each Docs answer has these controls:

| Control | What it does |
| - | - |
| **Copy response** | Copies the answer text |
| **Helpful answer** / **Unhelpful answer** | Rates the answer. Click the same button again to remove your rating. |
| **Regenerate last response** | Asks again for a new answer to your last question |

After you mark an answer as unhelpful, **Still stuck? Contact MainWP Support** appears under it. See [Contact MainWP Support](https://docs.mainwp.com/dashboard/mainwp-assistant/contact-support.md).

Ratings are saved with your conversation history, so they aren't available when conversation history is turned off.

## Switch Between Docs and Sites

Click **Docs** or **Sites** next to **Mode:**. The panel remembers your choice in this browser.

Sites mode uses your connected ChatGPT plan or API provider. Responses usually take 1 to 3 minutes. Changes ask for confirmation according to your access mode and **Confirmation Level**; **Destructive actions only** allows some changes to run without asking. See [Confirm or Cancel an Action](#confirm-or-cancel-an-action).

When Sites mode isn't available, the panel stays in Docs and tells you why:

* Below WordPress 7.0: "Sites mode needs WordPress 7.0 or newer. Docs mode works on this version."
* With no usable connection: open **AI Connection** and choose **Continue with ChatGPT** for your own plan. If your account can manage Dashboard settings, you can instead choose **Connect free AI** or **Manage AI Connectors** for an API key. See [Connect an AI Provider](https://docs.mainwp.com/dashboard/mainwp-assistant/settings-and-privacy.md#connect-an-ai-provider).

### When Docs Gets a Request to Change Something

If you ask Docs to do something on your sites, it may offer to move the request to Sites: "Review this request in Sites. When you send it, Sites uses your configured AI provider."

* **Continue in Sites** starts a new conversation in Sites mode with your request in the message box. It isn't sent until you send it.
* **Ask Docs instead** keeps the question in Docs.
* **Dismiss** closes the offer.

## Work with Your Sites in Sites Mode

In Sites mode, your connected ChatGPT account or API provider reads your request and calls MainWP actions on your behalf. It can only use the actions your access mode allows and the sites your account can access.

**1. Select Sites**

Next to **Mode:**, click **Sites**.

**2. Describe what you need**

Ask about your sites, for example "Which sites have plugin updates waiting?" and send it.

**3. Wait for the response**

Sites mode usually takes 1 to 3 minutes. The panel shows what it is doing, such as **Waiting for AI response...** or **Executing actions...**.

Each Sites answer shows the provider that answered and the tokens it used. When the provider's prices are known, it also shows an estimated cost, and the panel shows a running estimate for the conversation. These are estimates from published per-token pricing; your provider's bill may differ. ChatGPT plan requests show plan usage rather than an estimated API charge. Use **Manage usage** on the ChatGPT connection card to review your plan allowance.

Sites mode requests are blocked once the Dashboard reaches its daily AI spend limit. See [Spend Limits](https://docs.mainwp.com/dashboard/mainwp-assistant/settings-and-privacy.md#spend-limits).

### Confirm or Cancel an Action

When an action needs your approval, Sites mode shows it in the chat and waits for you.

* **Confirm Action** appears for a change, such as syncing sites or updating plugins.
* **Confirm Destructive Action** appears for an action that deletes or removes data. It says "This action will make permanent changes. Review the preview below:" and shows a preview first.

Each confirmation lists the **Action:** and the **Affected sites:**. Expand **Technical details** to see the exact action and inputs.

Click **Proceed** to run it or **Cancel** to stop. You can also type "yes" to proceed or "cancel" to dismiss. After a cancel, the panel shows "Cancelled. The action was not executed."

If an affected site has one of your protected tags, the confirmation also says "This affects sites with protected tags. Extra confirmation required."

Which actions need a confirmation depends on your settings:

| Your settings | What happens |
| - | - |
| **Read Only** access mode | Sites mode can't run actions that change data. If it tries, the panel shows "Action blocked. You are in read-only mode." |
| **Read & Write (with confirmation)** or **Full Access**, with **Confirm all changes** | Every action that changes data asks first |
| **Read & Write (with confirmation)** or **Full Access**, with **Destructive actions only** | Changes such as syncing or adding sites run without asking. Actions that delete or remove data still ask. |

Actions with their own preview step, such as running updates, always ask. See [Access Mode and Confirmations](https://docs.mainwp.com/dashboard/mainwp-assistant/settings-and-privacy.md#access-mode-and-confirmations).

### Long Operations

Some actions, such as updates across many sites, run as batch jobs on the Dashboard. The panel shows progress and how many sites succeeded or failed. If you leave the page, the job keeps running on the server; reload the page to see its progress again. Batch jobs are kept for 24 hours.

## Saved Conversations

Unless you turn off conversation history, the Assistant saves your conversations on your Dashboard for 30 days by default.

**1. Open Messages**

In the panel's tab bar, click **Messages**.

**2. Find a conversation**

Scroll the list or type in **Search conversations...**.

**3. Open it**

Click a conversation to open it and continue where you left off.

Each conversation in the list has three buttons:

* **Export as JSON** downloads the conversation as a JSON file.
* **Export as Markdown** downloads it as a Markdown file.
* **Delete conversation** asks for confirmation, then deletes it. This can't be undone.

The **Home** tab also shows your most recent conversation under **Recent Conversation**.

To change how long conversations are kept, export all of them, or delete all of them, see [History and Privacy](https://docs.mainwp.com/dashboard/mainwp-assistant/settings-and-privacy.md#history-and-privacy).

## Related Resources

* [MainWP Assistant Overview](https://docs.mainwp.com/dashboard/mainwp-assistant/overview.md)
* [Contact MainWP Support](https://docs.mainwp.com/dashboard/mainwp-assistant/contact-support.md)
* [Settings, Privacy, and History](https://docs.mainwp.com/dashboard/mainwp-assistant/settings-and-privacy.md)
* [Troubleshooting](https://docs.mainwp.com/dashboard/mainwp-assistant/troubleshooting.md)


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