Domains control where your Userback widget and surveys are displayed. When you add a domain to your project, Userback will only display on pages that match, so it shows up exactly where you want it, and nowhere else.
Getting your domain configuration right is one of the most important steps in your Userback setup, a few minutes spent here will save a lot of troubleshooting later.
How to Manage Your Domains
Open your project and go to the Overview tab.
Click the domain link below your project name. A Project Domains modal will open.
Enter the URL of the site where you want the widget to appear.
To add more domains, click Add Domain and enter each URL.
Click Save to confirm your changes.
⭐ Recommended: Once you've added your domain and installed the code we recommend that you verify your installation. Click the 'Install Code' (<>) button in the top menu and select Verify Installation. Each domain should show a green tick.
📘 Note: For local testing, use https://localhost as your domain. You can also use wildcard domains, for example, *.yoursite.com will display the widget on any URL that includes that domain.
Troubleshooting: Widget Not Showing
If your widget isn't appearing after adding your domain, check the following:
Incorrect Domain: Confirm the domain in your project settings exactly matches the URL where the widget is installed. A difference as small as www vs. non-www will prevent it from displaying.
Widget not set to Live: Go to your Project Overview and confirm the widget status is set to Live. If it's not Live, the widget will not appear regardless of your domain settings.
Check domain verification: Open the 'Install Code' (
<>) menu in the top header and click Verify Installation. Each domain should show a green tick, confirming the domain is correctly configured and the code is installed on your site. If it doesn't, check that the domain matches your site URL exactly and that the code snippet is present on your pages.
For a full troubleshooting guide, see Troubleshooting: The Userback Widget Isn't Showing.