Display the feedback button & widgets

Install the Usersnap Widget on Your Site or on Your App

Display the feedback button

The feedback button's displaying rule can be configured directly from the dashboard. You can define the URL where the button shall / shall not be seen. You could also limit the visibility to a certain target audience.

You can also trigger the feedback button only once per user if preferred.

Display the feedback widgets

Widgets from all feedback platform project types can be configured to pop up directly without the need to click on the feedback button. It can be triggered on page load or by time.

If your team wants to use your own feedback button, just choose "Auto Popup" in the Activation-setting. Open the widget via the API.

The displaying rule of this popup widget is also configurable just like the feedback button above. Moreover, you can even trigger the widget to be popped up if a certain event is fired.

See the event trigger example here.

You can also pop the widget once every X days.

Show the button only to logged-in users

Do you want to show the feedback button only to users who are "logged-in" into your app? This is a short guide on how to accomplish that.

While you or your developers are installing the Usersnap snippet code, take the precautions that you let this code be added to your installation snippet code.

In the Initialization of the Usersnap snippet code set the userID and the email . The userID will tell Usersnap that this user is logged into your application/service. What you put into this variable is not essential for Usersnap but if it's set you can use the "logged-in" audience.

🚧

Usersnap can not automatically detect that your users are logged into your web application/service or website. That's why you or your developers have to slightly modify the code.

<script>
  window.onUsersnapCXLoad = function(api) {
    api.init({
            user: {
            userId: "123", // this attribute defines that the user is logged in 
            email: "[email protected]", // OPTIONAL - this should be set by your developers with the email of your submitting users. 
            },
        });
    window.Usersnap = api; // expose the API to use it later in your HTML code
  }
  var script = document.createElement('script');
  script.defer = 1;
  // the API-Key here is the global API key already from your account
  script.src = 'https://widget.usersnap.com/global/load/[INSERT GLOBAL API KEY]?onload=onUsersnapCXLoad';
  document.getElementsByTagName('head')[0].appendChild(script);
</script>

After you are ready with that step, set in the "Configuration" menu - in the "Display" tab - the audience to "Logged in users" and the feedback button should be shown to only users who are logged in.

Show the button only to users with specific emails

Do you want to show the feedback button only to users who are logged with specific emails into your application? This is a short guide on how to accomplish that.

While you or your developers are installing the Usersnap snippet code, take the precautions that you let this code be added to your installation snippet code.

In the Initialization of the Usersnap snippet code set the email .

<script>
  window.onUsersnapCXLoad = function(api) {
    api.init({
            user: {
            email: "[email protected]", // essential to be set by your developers with the email of your submitting users. 
            },
        });
    window.Usersnap = api; // expose the API to use it later in your HTML code
  }
  var script = document.createElement('script');
  script.defer = 1;
  // the API-Key here is the global API key already from your account
  script.src = 'https://widget.usersnap.com/global/load/[INSERT GLOBAL API KEY]?onload=onUsersnapCXLoad';
  document.getElementsByTagName('head')[0].appendChild(script);
</script>

After you are ready with that step, set in the "Configuration" menu - in the "Display" tab - the audience to "Target specific users by email" and add the emails to whom the feedback button should be shown.

Updated 11 days ago


Display the feedback button & widgets


Install the Usersnap Widget on Your Site or on Your App

Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.