Introduction

Whether you're embedding Userback for the first time or enhancing an existing setup, this guide will provide the steps and tools you need to integrate seamlessly into your projects.

New to Userback? Check out our Getting Started Guide for a non-technical overview.

1. Sign Up and Set Up Your Workspace

Start by signing up for a free 14-day trial. After logging in, follow these steps:

1. Create your first project in Userback.
2. Copy your Userback Access Token, found by clicking the Code Icon in the top-right corner of your workspace.
3. Add your domain to your project for widget targeting.

2. Install the Widget

Follow these installation methods based on your development environment:

Option 1: Using Package Managers

Install Userback into your project using npm or yarn:

JavaScript

npm i @userback/widget

React

npm i @userback/react

Vue

npm i @userback/vue

Option 2: Using a Script Tag

For simpler setups, embed the widget directly into your HTML:

<script src="https://static.userback.io/widget/v1.js"></script>
<script>
  Userback.init('your_userback_access_token');
</script>

3. Implement User Tracking

Take full advantage of Userback’s User Identification feature to personalize feedback and link submissions to individual user profiles.

Userback.init('your_userback_access_token', {
  user_data: {
    id: "123456", // Unique user ID
    info: {
      name: "John Doe", // User name
      email: "[email protected]" // User email
    }
  }
});

For React or Vue projects, refer to our React or Vue documentation.

4. Customize Your Widget

Ensure the widget matches your brand and objectives:

• Appearance: Use the Widget Editor to adjust colors, labels, and placement.
• Behavior: Configure targeting rules to display widgets on specific pages or conditions.
• Data: Attach Custom Data for deeper context in feedback submissions.

5. Start Collecting Feedback

Once the widget is live, feedback will automatically populate in your Userback Dashboard.

Alternative Feedback Collection Methods

1. Browser Extension

Perfect for internal use cases or when embedding the widget isn't ideal. Install the Userback Browser Extension to collect and share feedback instantly.

2. REST API

Programmatically collect and manage feedback using our REST API.

🛟 Support

Need help? Here’s how to get assistance:

1. Log in to your Userback workspace.
2. Click the Help Center icon in the top-right corner.
3. Select Contact us to start a chat with our support team.