Projects

A project represents a single app, website, or subdomain. Each project has its own widgets, feedback inbox, and settings.

One Project = One App

The golden rule: one project per app/domain.

• app.example.com → Project A
• admin.example.com → Project B
• docs.example.com → Project C
• Mobile App → Project D

This ensures feedback is clearly attributed to the correct application.

Creating a Project

1. Navigate to Projects in the sidebar
2. Click "Create Project"
3. Enter project details:
   • Name: A friendly name (e.g., "Main App", "Admin Dashboard")
   • Domain: The domain where you'll install the widget
4. Click Create

Your project is created with a default widget ready to configure.

Project Settings

Click on a project to access its settings:

General

• Name: Change the display name
• Domain: Update the associated domain
• Delete: Permanently delete the project

Privacy

Control what data the widget collects:

See Privacy Controls for details.

Widget Code

Copy your embed code from here:

<script 
  async 
  src="https://userhero.co/widget.js" 
  data-key="pk_live_xxxxx">
</script>

Managing Widgets

Each project can have multiple widgets:

1. Go to your project
2. Click "Widgets" tab
3. Click "Create Widget" or select an existing widget

Different widgets for different use cases:

• General feedback on all pages
• Bug report widget for logged-in users
• Rating widget after completing tasks

Feedback Routing

Configure how feedback from this project is routed:

1. Go to project settings
2. Navigate to Integrations
3. Set up Slack, email, or webhook destinations

Project Limits

When you reach your limit, you'll need to upgrade to create more projects.

Deleting a Project

1. Go to project settings
2. Scroll to Danger Zone
3. Click "Delete Project"
4. Confirm deletion

Next Steps