Help & Troubleshooting

Something not working the way you expected? You’re in the right place. Most issues have a simple fix — browse the common problems below and you’ll likely be sorted in a few minutes.

🔴 The chat button isn’t showing up on my website

The most common reason: An API key hasn’t been saved yet. The chat button only appears after you’ve entered and saved your key.

Fix it:

1. Go to your WordPress Dashboard → Settings → AI Navigator
2. Make sure the API Key field has a key in it (the page will say “Key saved” if one is stored)
3. If the field is empty, follow Step 2 of the Install Guide to get and enter a key
4. Click Save Settings
5. Visit your website in a new tab and look for the chat button in the bottom-right corner

Other things to check:

• Make sure the plugin is activated — go to Plugins → Installed Plugins and confirm AI Navigator shows as “Active”
• Try clearing your browser cache (hold Shift and click the refresh button)
• Try opening your site in a different browser or a private/incognito window

🔴 The assistant gave wrong or outdated answers

Why this happens: The assistant’s knowledge of your site updates automatically once a day. If you’ve recently added new pages or posts, it might not know about them yet.

Fix it:

1. Go to Settings → AI Navigator
2. Scroll down and click Rebuild Index Now
3. Test the assistant again — it should now know about your latest content

🔴 The assistant says it can’t help or gives very generic answers

Why this happens: This usually means the assistant reached its usage limit, or there’s a problem with the API key.

Fix it:

1. Go to Settings → AI Navigator and check that your API key is still valid
2. Log in to your AI provider’s website (OpenAI, Anthropic, or Google) and check that your account is active and has credits or is within the free tier
3. If your key expired or was deleted, create a new one and update it in the plugin settings

🔴 I’m seeing a “Too many requests” message

Why this happens: To protect your account from misuse, the plugin limits how many questions can be asked per hour from the same location. This is a safety feature.

Fix it:

1. Wait an hour and try again — the limit resets automatically
2. If you’re running a busy site and need a higher limit, go to Settings → AI Navigator → Max requests per hour and increase the number (up to 200)

🔴 I changed something and now the key isn’t working

Why this happens: If you’ve changed your WordPress security keys (an advanced setting in WordPress), the encrypted API key stored by the plugin may no longer be readable.

Fix it:

1. Go to Settings → AI Navigator
2. Re-enter your API key in the API Key field
3. Click Save Settings

This re-encrypts the key with your current settings and everything should work again.

🔴 The Google Gemini assistant isn’t responding

Why this happens: Google Gemini has built-in content safety filters. Occasionally these filters block a response even for normal questions.

Fix it:

• Try rephrasing the question differently
• If it happens often, consider switching to a different AI provider (OpenAI or Anthropic) in your plugin settings

🔴 The chat widget is showing up on pages where I don’t want it

Why this happens: By default, the chat button appears on all pages of your website.

Fix it: This requires a small code addition to your WordPress theme. If you’re comfortable with that, check our support resources for instructions. If not, feel free to contact us and we can walk you through it.