--- doc_version: "1.0.0" last_updated: "2026-07-14T15:00:57.718Z" title: "Troubleshooting & FAQ" description: "Solutions for common ChatbotIQ issues: widget not showing, bot not answering correctly, crawling problems, credits running low, and frequently asked questions." keywords: [troubleshooting, FAQ, common issues, widget problems, crawling errors, ChatbotIQ help] --- Having an issue? Start here. This page covers the most common problems and their solutions. --- ## Widget not showing on your website 1. **Check privacy mode** - your bot must be set to **Public**. Go to Bot Settings → Privacy and switch to Public. 2. **Check the Active toggle** - make sure your bot is active (not paused). 3. **Check Allowed Domains** - if you've set domain restrictions, make sure your website's domain is in the list. 4. **Check script placement** - the embed code must be before the closing `` tag. 5. **Hard refresh** - try Ctrl+Shift+R (or Cmd+Shift+R on Mac) to clear your browser cache. 6. **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 1. **Check your sources** - are they crawled and indexed successfully? The status should show **Ready** on the Knowledge Base page. 2. **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. 3. **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. 4. **Check the language setting** - make sure the bot's response language matches your content and audience. 5. **Refine the system prompt** - give the bot clearer instructions about its role, tone, and scope. 6. **Check for crawl issues** - if pages came back empty or truncated, see the crawling section below. --- ## Crawling problems ### 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](/how-to/configure-crawling-for-your-site/). --- ## 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](/reference/plans-credits-and-pricing/). --- ## Credits running low - **Check model costs** - different models use different amounts of credits. See the [model pricing table](/reference/plans-credits-and-pricing/#credit-costs-by-model). - **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 **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](/explanation/security-and-privacy/) for details. **What AI models are available?** ChatbotIQ supports models from OpenAI (GPT-5 family), Anthropic (Claude), Google (Gemini), and Mistral (Mistral Small 3.2 and Mistral Medium 3.5). See [Choosing the Right AI Model](/explanation/ai-models-compared/) 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](https://chatbotiq.eu).* ## Sitemap Full documentation index: [sitemap.md](/sitemap.md) and [llms.txt](/llms.txt).