Skip to main content
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.
  • 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.

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: After you mark an answer as unhelpful, Still stuck? Contact MainWP Support appears under it. See Contact MainWP Support. 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. 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.

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.

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: Actions with their own preview step, such as running updates, always ask. See 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.