Install the Userback Widget
Learn how to quickly and easily add the Userback feedback widget to your website or app for Basic or Advanced Users
Daniel Rae avatar
Written by Daniel Rae
Updated over a week ago

Installing the Userback widget is a crucial step in getting started with Userback. This guide will walk you through the process of adding the Userback Widget Code to your website or app, ensuring that you are able to receive valuable feedback from your users.

For those looking for a more streamlined approach, the Userback Browser Extension offers a no-code alternative that makes it easy to add feedback without installing the Widget.

Basic Installation Guide

This guide provides a simple and straightforward way to add the Userback widget to your website or app. It's suitable for those who just want the most simple way to add the widget and only need to apply basic customizations.

  1. Access Widget Settings

    Log in to your Userback account and access the Widget Settings for the project you want to add the widget to.

  2. Copy Widget Code

    Locate the </> Widget Code card in the Widget Settings and copy the code provided. This code is unique to your Userback project and contains your unique widget token.

  3. Paste Widget Code

    Open the source code of the webpage where you want the widget to appear. Paste the widget code into the source code of the webpage, before the closing </head> or </body> tag. The ideal location for the widget code may vary depending on your website or app's layout and design.

  4. Save or upload your changes

    Congratulations! You have successfully installed the Userback widget on your website or app. If you encounter any issues or need further assistance, please don't hesitate to contact our support team.

Advanced Installation Guide

For those who want more control over the widget's behavior and integration with their website or app, including packages for popular frameworks such as React and Vue. It's also the recommended install option for advanced and single page application.

To get started, go to your Widget Settings in Userback and find the </> Widget Code card to copy the code provided. From there, choose the installation method that best fits your preference.

Advanced Method 1: Script Tag

When using the script tag method, the widget button is created by calling the init() method. This is the preferred option for single page apps. Add the following code to the head and body of your website or app.

<script src=""></script>

// Initializing Widget & Setting Userback Access Token
Userback.init('[YOUR_ACCESS_TOKEN]', {
on_load: () => {
console.log('Widget Load Successful');

Advanced Method 2: Official NPM Package

You can also install the Userback widget using npm by running the following command:

npm install @userback/widget


yarn add @userback/widget

Advanced Method 3: React

To install the Userback widget in a React application, run the following command:

npm install @userback/react


yarn add @userback/react

Advanced Method 4: Vue

To install the Userback widget in a Vue application, run the following command:

npm install @userback/vue


yarn add @userback/vue

Verify it's working

Manually checking to see if the Userback widget is loading on your website or app is the most reliable method of verification, as it allows you to directly observe the Userback script loading in your browser on a live webpage.

If you can't see the widget button, there are a few reasons that could be happening:

  • The widget has been customized: Review the widget customization options to ensure that the button is set to the correct look and location.

  • The widget is hidden: Check the widget targeting options to make sure that "On all pages where the widget code is installed" is enabled.

If you are still unable to see the widget button, don't hesitate to reach out for help. You can contact us directly for further assistance.

What next?

Who is this article for? πŸ”






User type





Did this answer your question?