Troubleshooting.
Common problems and how to fix them. Still stuck? Email us — we respond fast.
My widget isn't appearing on the page.
Check that the script tag is present in the HTML source (not injected by another script after render), the data-token is correct, and the chatbot status is Ready in the dashboard. If status shows Processing, wait 1-2 minutes for documents to finish indexing.
The widget says it has reached its monthly limit.
Your account has hit the query limit for this month. The limit resets on the 1st. Upgrade your plan from the Billing page to increase it.
Documents are stuck in Processing status.
Processing takes up to 5 minutes for large PDFs. If a document has been processing for more than 10 minutes, delete it and re-upload. Email [email protected] with your chatbot ID if it keeps happening.
The chatbot says it doesn't have information about something.
This means the similarity search didn't find a relevant chunk. Try uploading more comprehensive documentation, rephrasing the question using terms from your docs, or checking that documents embedded correctly (status should be Embedded in the Knowledge tab).
The widget conflicts with my site's styles.
The widget renders inside a Shadow DOM. If you're still seeing conflicts, check whether your site uses CSS reset rules that target the :host selector — these can occasionally pierce Shadow DOM boundaries.
I regenerated my embed token and the widget broke.
After regenerating, update the data-token attribute in every embed on your site. The old token is immediately invalidated.
Still stuck? Open a support ticket →