Troubleshooting & FAQ
Having an issue? Start here. This page covers the most common problems and their solutions.
Widget not showing on your website
Section titled “Widget not showing on your website”- Check privacy mode — your bot must be set to Public. Go to Bot Settings → Privacy and switch to Public.
- Check the Active toggle — make sure your bot is active (not paused).
- Check Allowed Domains — if you’ve set domain restrictions, make sure your website’s domain is in the list.
- Check script placement — the embed code must be before the closing
</body>tag. - Hard refresh — try Ctrl+Shift+R (or Cmd+Shift+R on Mac) to clear your browser cache.
- Check the console — open your browser’s developer tools (F12 → Console) and look for
[ChatbotIQ]error messages.
Still stuck? The most common cause is the bot not being set to Public mode. Double-check that first.
Bot not answering correctly
Section titled “Bot not answering correctly”- Check your sources — are they crawled and indexed successfully? The status should show Ready on the Knowledge Base page.
- Use the Debug panel — in the Playground, open the Debug panel to see retrieval scores. If scores are low, the bot isn’t finding relevant content.
- Lower the RAG threshold — if the bot can’t find content that you know exists, try lowering the RAG Score Threshold in bot settings to make retrieval more lenient (e.g., toward 0.1—0.2). The default sits around 0.30 (it varies by content type), and valid values range from 0.05 to 0.80.
- Check the language setting — make sure the bot’s response language matches your content and audience.
- Refine the system prompt — give the bot clearer instructions about its role, tone, and scope.
- Check for crawl issues — if pages came back empty or truncated, see the crawling section below.
Crawling problems
Section titled “Crawling problems”Quick fixes
Section titled “Quick fixes”| Symptom | Likely cause | Fix |
|---|---|---|
| Pages discovered but content is empty | JavaScript renders the content | Turn OFF Static Site Mode; enable Reader Mode |
| Content includes navigation/menus/footers | Page chrome not being stripped | Enable Reader Mode; add Content Selector if needed |
| Not all pages found (Standard mode) | Sitemap is incomplete | Switch to Advanced mode to discover via links |
| Not all pages found (Advanced mode) | Links hidden in JavaScript | Enable Enhanced SPA Detection; add Manual URL Seeding |
| Pages show partial/truncated content | Content loads slowly via JavaScript | Increase Content Load Delay to 2—3 seconds |
| Crawler gets rate-limited (429 errors) | Too many concurrent requests | Lower Concurrency to 2—3 |
| Same page appears with different URLs | Query parameters creating duplicates | Turn OFF Preserve Query Strings |
| Very slow crawling | Browser overhead on a simple site | Enable Static Site Mode (if site is static HTML) |
For detailed crawling configuration, see Configure Crawling for Your Site.
Page limit exceeded
Section titled “Page limit exceeded”Your plan has a maximum number of indexed pages. If you’ve hit the limit:
- Delete unused sources or pages — the counter decreases automatically when you remove content.
- Exclude unnecessary pages — during the review step before crawling, deselect pages you don’t need.
- Upgrade your plan — higher plans have larger page limits. See Plans, Credits & Pricing.
Credits running low
Section titled “Credits running low”- Check model costs — different models use different amounts of credits. See the model pricing table.
- Switch to a more efficient model — GPT-5 Mini (1x multiplier) is the most cost-effective option.
- Buy top-up credits — purchase additional credits from the Billing page.
- Upgrade your plan — higher plans include more monthly credits.
Frequently asked questions
Section titled “Frequently asked questions”Can I use the same bot on multiple websites? Yes. The embed code works on any website. Use Allowed Domains in bot settings to restrict which sites can load it.
Can I have multiple bots with different sources? Yes. Each bot can use a different subset of your knowledge sources, or all sources at once. For example, you might have one bot for product docs and another for your blog.
How often should I refresh my sources? Whenever your website content changes significantly. Use the Refresh button on the Knowledge Base page. ChatbotIQ will show you which pages changed, which stayed the same, and which failed.
What happens when I delete a source? All indexed content from that source is removed from your knowledge base, and your page count decreases. Bots that used that source will no longer be able to reference its content.
Can my bot answer questions in multiple languages? Your bot’s response language is set in bot settings. It will respond in that language regardless of the language the user types in. If you need bots in multiple languages, create separate bots with different language settings.
Is my data secure? ChatbotIQ is built and hosted in Europe, with GDPR compliance built in. See Security, Privacy, and GDPR for details.
What AI models are available? ChatbotIQ supports models from OpenAI (GPT-5 family), Anthropic (Claude), and Google (Gemini). See Choosing the Right AI Model for guidance on which to pick.
Need more help? Use the Contact Support button in the bottom-left corner of your dashboard to send us a message directly — you can describe your issue and attach screenshots. You can also reach us at chatbotiq.eu.