Troubleshooting
Chat Widget Is Not Showing
Follow these checks when the AIChatVault widget does not appear, loads only on certain pages or behaves differently between environments.
Verify installation
- •Confirm the complete embed snippet appears once before the closing body tag.
- •Confirm the deployed agent identifier matches the intended agent.
- •Publish or clear the cache for your website after changing the template.
- •Check the browser console for blocked scripts or content-security-policy errors.
Check domain and page scope
- •Confirm the current hostname is allowed in the agent’s deployment settings.
- •Check whether a tag manager or consent manager delays the script.
- •Test a page using the same site template where the widget is known to work.
- •Test in a private browser window with extensions disabled.
Check visibility settings
Confirm the widget is enabled and not hidden by page-specific rules, responsive CSS or another element with a higher stacking order.
Need more help? If the issue continues after these steps, contact AIChatVault support and include the agent, channel or integration involved and what you expected to happen.
