What You’ll Learn
- Open Assistant Settings
- Connect an AI provider for Sites mode
- Choose an access mode, confirmation level, and protected tags
- Set daily spend limits
- See what the Assistant sends to MainWP and to your AI provider
- Keep, export, or delete conversation history
- Turn the Assistant on or off
- Review Assistant usage in Dashboard Insights
Prerequisites
- A WordPress administrator account
- The Access MainWP Settings permission if you use Team Control. Accounts without it can connect their own ChatGPT plan and manage their own history; Dashboard-wide API-key settings still require that permission.
Open Assistant Settings
Open the Assistant panel and click Settings in the tab bar, or go to/wp-admin/admin.php?page=AssistantSettings.
The page has three tabs:
Connect an AI Provider
Sites mode can use your own ChatGPT plan or an AI provider API key. It needs WordPress 7.0 or later. Docs mode does not need an AI connection.Connect Your ChatGPT Plan
Under Use your ChatGPT plan, click Continue with ChatGPT. Sign in in the new tab and approve MainWP. The tab then ends on an error page such as “This site can’t be reached”; this is expected for this connection flow. Copy the full address from that tab, paste it into Paste the address from the error page on your MainWP Dashboard, and click Finish connecting. Paste it only into your own Dashboard because it contains temporary sign-in credentials. Each Dashboard user connects their own account. When connected, the card shows Using ChatGPT plan. Use Model to choose from your account’s available models, Manage usage to review usage, or Disconnect to stop using the plan. While your plan is connected, your Sites requests use it rather than a saved API key. Disconnect the plan to use an API key yourself. Other Dashboard users without a connected plan use the configured API provider. If the plan needs reconnection or is turned off for MainWP, reconnect or explicitly disconnect it before switching to an API key; MainWP does not silently fall back.Use an API Key
Open Assistant Settings > AI Connection. The tab shows:- WordPress version: Sites mode needs WordPress 7.0 or newer.
- AI Client: Available when WordPress can send AI requests. Disabled on this site means AI features are turned off in WordPress. Requires WordPress 7.0 or newer means the site needs an update.
- Sites mode: Ready. Found a configured AI provider. or a message that no provider was found.
Option 1: Connect a Free Google Gemini Key
If no provider is set up, the Google Gemini row offers Connect free AI. It stores a Google AI Studio key for you and picks a free-tier model.1
Start the wizard
Click Connect free AI.
2
Get key
Sign in to Google AI Studio. Click Get API key, then Create API key, and copy the key.
3
Paste
Paste the key into Google API key. Google AI Studio keys usually start with
AIza.4
Verify
The wizard checks the key with Google. When it works, you see “Connected. Sites mode is on, using” followed by the model name. If it asks you to reload the page, reload it before you switch to Sites.
wp-config.php or an environment variable, that key takes priority and the wizard tells you to change it where it is defined.
Option 2: Use Another Provider
Click Manage AI Connectors to open Settings > Connectors in WP Admin. Install the provider’s plugin, such as one for OpenAI or Anthropic, and add its API key there. Return to AI Connection and check that Sites mode reads Ready.Preferred Model
For API-key connections, Model Preference > Preferred model is optional. A connected ChatGPT plan uses the Model selector on its own card instead. Enter a model ID, such asgpt-5-mini, and click Save. The Assistant asks for that model first and falls back to any available model. Leave it empty to let WordPress choose.
Access Mode and Confirmations
Open Assistant Settings > AI Access Policies. Changes on this tab save as soon as you make them. Access Mode, Confirmation Level, and Protected Tags apply to your account only.Access Mode
Full Access doesn’t skip confirmations. An action that deletes or removes data still shows a preview and asks you to confirm before it runs, and your Confirmation Level applies to other changes.
Confirmation Level
Confirmation Level appears when your access mode isn’t Read Only. Under Ask for confirmation, choose:- Confirm all changes (default): every action that changes data asks for your approval first.
- Destructive actions only: changes such as syncing or adding sites run without asking. Actions that delete or remove data still ask.
Protected Tags
Select tags under Protected tags. Sites with these tags need an extra confirmation before the Assistant can change them, even in Full Access. If you have no tags yet, use the Manage tags link to create them.Spend Limits
Sites mode costs depend on your AI provider’s prices. The Assistant estimates spend from token counts and published provider prices; your provider’s bill may differ. Both limits are on AI Access Policies and need administrator access. MainWP records ChatGPT plan requests without an API dollar charge; review and limit that usage in ChatGPT. These dollar estimates do not measure your plan allowance.
Under each field, the page shows how much was used today. When the Dashboard reaches its limit, the chat shows “This dashboard reached its daily AI spend limit, so Sites mode requests are blocked until tomorrow.” with a Change the limit link for users who can change it. When a user reaches the per-user limit, the chat shows “You reached your daily AI spend limit, so your Sites mode requests are blocked until tomorrow.”
What the Assistant Sends and Where
The Enable Assistant Features dialog lists these points before anyone can chat. In detail:
The Assistant does not automatically attach stored site credentials. Review what you type or paste into a conversation before sending it.
Guided tours and video tutorials use their own external services when those options are turned on. See Privacy & Data Handling.
History and Privacy
Open Assistant Settings > History & Privacy. These settings apply to your account only.
Click Save Settings after changing either one.
Under Manage History Data:
- Export History (JSON) downloads every conversation of yours, with its messages, as a JSON file.
- Clear All History permanently deletes every conversation of yours after you confirm. It can’t be undone, so export first if you want a copy.
Turn the Assistant On or Off
Turning the Assistant off removes the Assistant sidebar item and the panel for every user on the Dashboard. Saved conversations stay until each user clears them. Use any of these:- Assistant Settings > AI Access Policies > Global Assistant Toggle: switch Assistant availability. Turning it off asks you to confirm with Disable Assistant.
- MainWP menu (three lines, top right) > MainWP Tools > Privacy & Third-Party Services Permissions: MainWP Assistant (AI-Powered Chat Support).
- The toggle on the Support Assistant card in the Support modal, then Save Support Settings.
/wp-admin/admin.php?page=AssistantSettings. Administrators can turn it back on from AI Access Policies, and every user can still manage their history on History & Privacy.
Withdraw Consent
Under Assistant Features Consent, Disable Assistant Features withdraws the privacy consent for the Dashboard. It turns off the Assistant for everyone, and the Enable Assistant Features dialog appears again the next time someone opens it. Conversation history stays until it is cleared on History & Privacy.Review Assistant Usage in Insights
When the Assistant is on and the Logs module is enabled, MainWP > Insights (admin.php?page=InsightsOverview) includes four Assistant widgets:
The widgets show your own activity. With the Access MainWP Settings permission, you can filter by other users. Accounts limited to specific sites can’t see Assistant Insights. The Insights button in the panel header opens this page. See Dashboard Insights for filters and layouts.
