Skip to main content

Managing Domains

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

C
Written by Chris

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?