Configuration

The Userloop widget can be customized to match your brand and workflow needs.

# Widget Options

Configure the widget by adding data attributes to the script tag:

<script
  src="https://widget.userloop.run/widget.js"
  data-project-id="YOUR_PROJECT_ID"
  data-position="bottom-right"
  data-color="#29f28c"
  async
></script>

# Available Options

# Programmatic Configuration

For more control, use the JavaScript API:

window.userloop?.configure({
  projectId: "YOUR_PROJECT_ID",
  position: "bottom-right",
  color: "#29f28c",
  text: "Send Feedback",
  // Identify the current user
  user: {
    email: "user@example.com",
    name: "John Doe",
  },
  // Custom metadata attached to all feedback
  metadata: {
    plan: "pro",
    version: "2.1.0",
  },
});

# Controlling Visibility

# Show/Hide Programmatically

// Hide the widget
window.userloop?.hide();

// Show the widget
window.userloop?.show();

// Open the feedback form
window.userloop?.open();

// Close the feedback form
window.userloop?.close();

# Conditional Display

Only show the widget to certain users:

// Only show to logged-in users
if (currentUser) {
  window.userloop?.show();
  window.userloop?.identify({
    email: currentUser.email,
    name: currentUser.name,
  });
} else {
  window.userloop?.hide();
}

[!NOTE] The widget is hidden by default until you call `show()` when using programmatic control.

# Custom Trigger

Use your own button to trigger the feedback form:

<button onclick="window.userloop?.open()">Give Feedback</button>

Then hide the default button:

window.userloop?.configure({
  projectId: "YOUR_PROJECT_ID",
  showButton: false, // Hide the default floating button
});

# Integrations

# Linear Integration

Connect Userloop to Linear to create issues directly from feedback:

1. Go to Dashboard → Integrations → Linear
2. Click Connect Linear
3. Authorize Userloop to access your Linear workspace
4. Select the default team and status for new issues

# Jira Integration

Connect to Jira for issue tracking:

1. Go to Dashboard → Integrations → Jira
2. Enter your Jira site URL
3. Authenticate with Jira
4. Configure the default project and issue type

[!TIP] You can change the target project when creating individual issues from feedback.

# Workflows

# Auto-Tagging

Set up rules to automatically tag feedback based on content:

1. Go to Dashboard → Projects → Settings → Workflows
2. Click Add Rule
3. Define conditions (e.g., "feedback contains 'bug'")
4. Set the action (e.g., "add tag 'bug'")

# Notifications

Configure how you get notified about new feedback:

• Email: Daily digest or instant notifications
• Slack: Real-time alerts in your Slack channel

Set up notifications in Dashboard → Settings → Notifications.

# Next Steps

You're all set! Here are some things to explore:

• Review incoming feedback in your dashboard
• Set up team members to collaborate on feedback
• Explore the API for advanced integrations