Linear Integration

Turn customer feedback into actionable issues in Linear. Automatically create issues from negative feedback or manually create them from the dashboard.

Setup

1. Go to Integrations in the main navigation and find the Linear card

2. Click Connect

3. Select your Linear workspace

4. Authorize HappyPanda to access Linear

5. Choose your default team and labels

6. Configure auto-create settings

OAuth Permissions

HappyPanda requests access to:

• Read teams and projects
• Create issues
• Read labels and workflows

Configuration

Default Issue Settings

Configure defaults for new issues:

Setting	Description
Team	Which team receives new issues
Labels	Default labels to apply
Priority	Default priority level
Project	Optional project assignment

Auto-Create Rules

Configure when issues are created automatically:

• All feedback - Create an issue for every submission
• Low scores only - Only for NPS 0-6 or CSAT 1-2
• Manual only - Disable auto-create, create from dashboard

Start with low scores

We recommend starting with “Low scores only” to avoid issue overload, then expanding as needed.

Priority Rules

Set priority based on feedback:

Feedback Type	Suggested Priority
NPS 0-3 (Detractors)	High or Urgent
NPS 4-6 (Detractors)	Medium
Bug reports	High
Feature requests	Low

Issue Format

Issues created from feedback include:

Title: First line of feedback or auto-generated summary

Description:

User feedback from HappyPanda

Rating: 3/10 (Detractor)

Feedback:
"The checkout process is confusing. I couldn't find where to enter my discount code."

---
Submitted: January 18, 2025 at 2:30 PM
Email: [email protected]
Page: https://example.com/checkout
View in HappyPanda: [Link]

Labels: Automatically applied based on:

• Survey type (feedback, bug, feature-request)
• Custom labels from settings

Manual Issue Creation

Create issues manually from the dashboard:

1. Open a feedback submission in HappyPanda

2. Click Create Linear Issue

3. Select team and customize title/description if needed

4. Click Create

5. Issue link is saved with the submission

Best Practices

Create a Feedback project

Set up a dedicated “Customer Feedback” project in Linear to organize all feedback-related issues.

• Use labels to categorize - Create labels for bug, feature, feedback, urgent
• Set up automation in Linear - Auto-assign issues to team members
• Review and triage regularly - Don’t let feedback issues pile up
• Link back to HappyPanda - Issues include a link to the original submission

Troubleshooting

Issues not being created

1. Verify auto-create is enabled - Check Integrations → Linear settings
2. Check team permissions - Ensure you have permission to create issues in the selected team
3. Confirm integration status - Verify Linear shows as “Connected”
4. Check feedback matches rules - Auto-create only triggers for matching feedback

Issues created in wrong team

• Update team selection in Integrations → Linear settings
• Verify you have access to the correct team in Linear

Can’t see all teams

• Check your Linear workspace permissions
• Re-authenticate the Linear integration
• Contact your Linear workspace admin

Disconnecting Linear

1. Go to Integrations in the main navigation

2. Click Disconnect on the Linear card

3. Optionally, revoke HappyPanda access in Linear settings