Documentation/Troubleshooting/Chat Widget Is Not Showing

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.