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.

SLA Rules

Set response deadlines for each priority level. When feedback is created with a priority, the due date is automatically calculated.

1. Go to project settings
2. Open the SLA Rules section
3. Set hours for each priority level:

Leave a value at 0 to skip that priority level. A background check runs every 15 minutes to flag items that exceed their deadline.

Custom Fields

Add structured form fields to your widget so users can provide specific information when they submit feedback. Fields are defined at the project level and can be enabled per widget.

See Custom Fields for the full guide.

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