Skip to main content

Managing Domains

How to add, verify, and manage the domains your Userback widget is allowed to run on.

Written by Jon

The widget only loads on domains you've added here. This keeps it from accidentally showing up on a staging copy, a fork, or someone else's site that happens to load your script.

Open Site Settings

You can reach the same Site Settings modal's Domains tab from any of these three places:

  • The Site card's ··· menu > Manage Domains, from the Sites list.

  • The ⚙ Update site domains link on the Dashboard.

  • Site Settings > Domains, directly.

Add a domain

  1. In the Domains tab, click Add domain.

  2. Enter the domain exactly as it appears in your site's URL. For local testing, use https://localhost.

  3. To cover every subdomain at once, use a wildcard, for example *.yoursite.com.

  4. Repeat for any additional domains, then close the modal. Changes save automatically.

Verify a domain

Verify Installation checks whether the widget has actually loaded on the domain, not just whether it's listed here. Open the domain in a browser and refresh it first, so the widget script runs at least once, then go to Feedback > Settings > Widget > Install and click Verify Installation. Each domain you've added shows a green checkmark once Userback has seen the widget load there.

Common issues

  • Domain mismatch. The domain here has to match your install URL exactly: www.example.com and example.com count as different domains.

  • Site not Live. A paused or non-Live site won't show the widget even with a verified domain.

  • Still not verifying? Run Verify Installation again after fixing the domain or site status.
    ​
    See Troubleshoot: The Userback Widget Isn't Showing for the full diagnostic list.

What's next

Related articles

Did this answer your question?