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