Linear Integration

Connect BuildBetter with Linear to transform customer insights into actionable project tasks

Connect BuildBetter with Linear to automatically create and track issues based on customer conversations, ensuring feedback directly influences your product roadmap.

Features

• Automated Issue Creation: Generate Linear issues from meeting signals and insights
• Project Linking: Link custom objects to Linear projects for tracking development work
• Author Mapping: Map Linear users to BuildBetter teammates for accurate ownership and attribution — including off-domain Linear accounts that don’t match by email
• Linear Evidence Tracker (early access): Tracked Linear issues automatically receive evidence-backed comments that update as new customer signals arrive — see the Linear Evidence Tracker docs
• PR Ticket Suggestions: In triage, BuildBetter suggests existing Linear tickets that match an inbound PR so reviewers can attach the right context with one click
• Custom Workflows: Map conversation signals to specific Linear teams and projects
• Rich Context: Include meeting snippets, timestamps, and customer details in issues
• Two-way Sync: Update status in either system and keep everything in sync
• Priority Mapping: Convert customer sentiment and frequency into Linear priority

Setup Guide

Prerequisites

1. Linear Requirements:

   • Linear account (any paid plan)
   • Admin access for API key generation
   • Teams and projects configured

2. BuildBetter Requirements:

   • Active BuildBetter account
   • Admin privileges for integration setup

Installation Steps

1. Connect Linear

   • Go to Settings > Integrations in BuildBetter
   • Click “Connect” under Linear
   • Enter your Linear API key
   • Select teams and projects to connect

2. Configure Workflows

   • Map signal types to Linear teams/projects
   • Set up issue template mappings
   • Configure priority and status defaults
   • Define custom field mappings

3. Test Integration

   • Create a test signal
   • Send to Linear
   • Verify issue creation and field mapping

Usage

Creating Issues from Conversations

After a customer call:

• Review and approve extracted signals
• Select “Send to Linear” from the signal actions menu
• Choose team, project, and other attributes
• BuildBetter creates a detailed issue with context

Bulk Issue Creation

For multiple signals:

• Filter signals by type, meeting, or customer
• Multi-select relevant signals
• Use “Bulk Actions” → “Send to Linear”
• Apply team/project mapping

Workflow Automation

Example automated workflows:

• Feature request signals → Product team issues
• Bug reports → Engineering team issues
• UI/UX feedback → Design team issues
• Customer success concerns → CS team issues

Templates and Formatting

BuildBetter creates Linear issues with:

• Clear, automatically generated titles
• Detailed descriptions with context
• Embedded audio/video clips when relevant
• Customer attribution and metadata
• Links back to the full conversation

Project Linking

Link your BuildBetter custom objects (like Cycles, Initiatives, or custom entities) directly to Linear projects. This creates a live connection between customer feedback and your development work.

How It Works

Custom objects can have an “integration object” property that links to Linear projects. Once linked, you can:

• See the project name and status directly in BuildBetter
• Click through to the project in Linear
• Update project status from BuildBetter
• Filter custom objects by linked project

Linking a Project

1. Open a custom object with a Linear project property
2. Click the property field
3. Choose from:
   • Link existing project: Search and select from your Linear projects
   • Create new project: Create a new Linear project and link it immediately

Project Actions

Once a project is linked, you can:

Action	Description
View in Linear	Click the external link icon to open the project in Linear
Mark as Done	Update the project status to “completed”
Unlink	Remove the link without deleting the Linear project
Refresh	Update the cached project data from Linear

Status Indicators

Linked projects display their current status with color-coded badges:

• Backlog (gray): Not yet started
• Planned (blue): Scheduled for work
• Started (yellow): In progress
• Paused (red): On hold
• Completed (green): Finished
• Canceled (gray): Not proceeding

Filtering by Project

You can filter custom object lists by linked Linear project to:

• See all items related to a specific project
• Track customer feedback driving a project
• Monitor progress across related work

Author Mapping

Map Linear users to BuildBetter teammates so ownership, attribution, and assignee carry-over work correctly — especially for Linear accounts that use a different domain than the email teammates use in BuildBetter.

Where to Manage Mappings

Go to Settings → Features → Linear Authors in BuildBetter. The mapping screen shows:

• The full Linear workspace roster
• Highlights for unmapped Linear users
• A clear distinction between auto-mapped (email matched) and manual mappings
• Quick controls to assign the correct teammate for each Linear user

Why It Matters

Once mappings are in place:

• Assignee carry-over works when promoting or attaching tickets — the right teammate appears as the assignee in Linear
• Evidence and routing correctly attribute work to the person who actually owns it
• Triage suggestions can recommend the right Linear assignee when promoting signals

Linear Evidence Tracker

Early Access — rolling out alongside Topics.

Tracked Linear issues can receive evidence-backed comments in Linear that update as new customer signals arrive. The comment summarizes what customers are saying, with quotes, customer names, source platform labels, and dates — and refreshes automatically as new evidence is matched to the issue.

See the full Linear Evidence Tracker documentation for setup and usage.

PR Ticket Suggestions

When an inbound PR shows up in triage, BuildBetter suggests existing Linear tickets that look like a match. Reviewers can attach the suggested ticket directly from the PR detail panel — no manual searching. Promoted tickets disappear from triage immediately without needing a page refresh.

Advanced Configuration

• Custom Fields: Map BuildBetter signal attributes to Linear custom fields
• Labels: Automatically apply labels based on signal classification
• Relations: Create issue relationships based on related signals
• Webhooks: Trigger BuildBetter actions when Linear issues change status

Support

Need help? Contact us:

• Email: [e-mail]
• Visit our Help Center
• Schedule a setup call