What You’ll Learn
- Why the Assistant panel or sidebar item may be missing
- How to fix Sites mode and AI provider messages
- What the documentation service and spend limit messages mean
- Why an action was blocked
Prerequisites
- Access to Assistant Settings. Some fixes need a WordPress administrator with the Access MainWP Settings permission.
The Assistant Doesn’t Show
The Assistant item is missing from the sidebar, and Command + K has no Assistant results.- The Assistant is turned off. Turn it on under MainWP menu (three lines, top right) > MainWP Tools > Privacy & Third-Party Services Permissions or at
/wp-admin/admin.php?page=AssistantSettings&tab=policies. See Turn the Assistant On or Off. - Your account can’t use it. The Assistant opens only for WordPress administrators who can access the Dashboard’s Overview.
- You’re not on a MainWP page. The panel loads on MainWP Dashboard pages only, not on other WP Admin screens.
Consent Messages
“Assistant features are off. Ask a dashboard administrator to enable them.” No administrator has accepted the privacy notice yet, and your account can’t accept it. Ask an administrator with the Access MainWP Settings permission to open the Assistant and click Enable & Continue. “The Assistant needs privacy consent before it can answer. An administrator can grant it in Assistant settings.” Consent was withdrawn. An administrator can click Enable Assistant Features under Assistant Settings > AI Access Policies > Assistant Features Consent.Sites Mode and AI Provider Messages
“Sites mode needs an AI provider with a working API key. Add or check one in Settings > Connectors, then try again.” “No AI connection is configured.” “No AI connection is configured, so Sites mode cannot answer.” Sites mode has no connection it can use. Open Assistant Settings > AI Connection and choose Continue with ChatGPT for your own plan, or connect an API key with Connect free AI or Manage AI Connectors. See Connect an AI Provider. Docs mode keeps working while you set this up. “Answered from MainWP docs. Sites mode needs an AI connection with a provider API key under Settings > Connectors.” You sent a request in Sites mode, but no provider was available, so Docs answered instead and the panel switched back to Docs. Connect a provider, then select Sites again. “Sites mode needs WordPress 7.0 or newer. Docs mode works on this version.” Update WordPress on your Dashboard site to 7.0 or later. Until then, use Docs mode. “Your AI provider rejected the API key for this dashboard. Check the key under Settings > Connectors.” The provider didn’t accept the key, for example because it is wrong or was revoked. Replace it under Settings > Connectors, or click Replace key on AI Connection if you used Connect free AI. “AI provider rate limit reached. Wait a moment and try again.” Your provider limits how many requests you can send. Wait and try again. If the message shows a Try again in countdown, wait for it to finish. “Gemini free-tier quota reached. A per-minute limit clears within a minute; the daily quota resets at midnight Pacific.” You reached a limit on Google’s free tier. Wait, or switch to a paid key. “Could not reach your AI provider. Check the connection and try again.” or “Your AI provider is having trouble right now. Please try again in a moment.” The provider didn’t answer. Try again later. Docs mode isn’t affected.ChatGPT Plan Messages
- “Connect your ChatGPT account again to use your plan.” Open AI Connection and reconnect.
- “You’ve reached your ChatGPT plan limit for MainWP.” Use Manage usage on the connection card to review the plan limit.
- “This ChatGPT account can’t use its plan in other apps.” The account is not eligible for this connection. Use an eligible account or disconnect the plan and configure an API key.
- “ChatGPT is not available right now. Try again in a few minutes.” Retry later.
