Quickstart Guide

You can install the Userback JavaScript library as an NPM package or as an HTML script snippet.

Check out our Javascript API for additional advanced configurations and use cases, like customizing your widget or identifying users.

1. Create an Account

To create a Userback account, navigate to app.userback.io and fill in your details to sign up for your free trial.

2. Install / Initialize

You will need your Userback Widget Token for initializing your library. You can get your project-specific Userback Widget Token from Widget Customiser.

Option 1: NPM/Yarn

This library is available as a package on NPM, use the following to install into a project using NPM/Yarn with a front-end bundler.

npm install @userback/widget

yarn add @userback/widget

Option 2: HTML Embed code

Paste the HTML embed code snippet within the <body> tag of your page and initialize with your Userback Widget Token.

<script>
    window.Userback = window.Userback || {};
    Userback.access_token = 'Userback Widget Token';
    (function(d) {
        var s = d.createElement('script');s.async = true;
        s.src = 'https://static.userback.io/widget/v1.js';
        (d.head || d.body).appendChild(s);
    })(document);
</script>

Option 3: HTML Script tag

Paste the HTML script tag snippet within the <head> tag of your page and initialize with your Userback Widget Token.

<head>
    <script src="https://static.userback.io/widget/v1.js"></script>
</head>

<body>
    <script>
    Userback.init('Userback Widget Token', {
        email: '[email protected]',
        name: 'Adriane Ross',
        on_load: () => {
            console.log('widget is loaded');
        }
    });
    </script>
</body>

Option 4: Browser Extension

The Userback browser extension is an easy no-code way to quickly provide feedback on any website or web application.

Simply download and install the extension and you're ready to start submitting feedback. For ease of use, you can also set up your domains for filtering feedback into projects. Learn more about installing and setting up your Userback browser extension

3. Collect Feedback

Let's get started by submitting some test Feedback. You can submit feedback from wherever it's been installed.

If the widget is not visible, check out the Widget Customiser in your Project Settings. More information about Audience and Page Targeting can be found here.

4. Check for Success

Open up the Feedback page in Userback to view incoming feedback.

If you need any assistance, we are here to help, use the click here to check out our help & support options and choose your preferred method to solve your query.