Controlling where the widget appears

HaloDesk gives you full control over where your chat widget is allowed to load.

This is useful if you want to restrict the widget to specific websites or environments.


Restricting widget domains

In the Install section of the Deploy tab, you can specify allowed domains.

When domain restrictions are enabled:

  • The widget will only appear on the domains you list

  • The widget will not load on any other website, even if the script is present

This helps prevent:

  • Accidental installs on staging or test sites

  • Widget usage on unauthorized domains


Common use cases

Domain restrictions are useful when:

  • You manage multiple websites

  • You use staging or development environments

  • You want separate agents for different domains


Turning the widget off without removing code

You can disable the widget at any time using the enable/disable toggle at the top of the Deploy tab.

When disabled:

  • The widget will not appear on your website

  • The script can remain installed

This is helpful for:

  • Temporary maintenance

  • Pausing support

  • Testing changes safely


Best practices

  • Always restrict domains in production

  • Use separate agents for separate websites

  • Disable the widget instead of removing code when troubleshooting


Was this article helpful?
© 2026 HaloDesk