Overview
Connect customer feedback in Enterpret to execution in Linear so teams can see what's already being worked on, link feedback to the right Linear issues or projects, and make decisions with full context.
These are collectively referred to as work items throughout this guide.
What This Solves
The problem it solves:
Feedback and delivery live in separate tools, making it unclear whether an idea is new, planned, or already in progress
Manually linking Linear work items to feedback wastes time and loses valuable context
Closing the loop with customers is difficult without a direct connection to who asked and why
What this integration unlocks:
Link Linear work items to Enterpret entities (Feedback Records, Themes/Sub-themes, Feeds & Collections)
View linked Linear work items as preview cards with key details in Enterpret
View backlinks to Enterpret and the number of linked feedback items directly in Linear via a Linear Doc
Who This Is For
CX, Product, and Engineering teams who want a shared source of truth linking feedback to execution.
Setup Instructions
Prerequisites
You're an Enterpret admin and have permissions to configure integrations
You have a Linear workspace with admin or owner rights for OAuth consent
Permissions required during consent:
Read access — to fetch issue or project details for preview cards
Write access — for creating Linear Docs with Enterpret references
Admin access — for creating webhooks for real-time updates
Step 1: Enable the Integration
In Enterpret, go to Integrations → New Integration → Linear
Select Linear and continue to OAuth
Review and approve requested scopes using a Linear admin account
You'll be redirected back to Enterpret
Step 2: Configure Access Control
We recommend using a service user (an admin user not tied to an individual) so the connection remains stable even if someone leaves the team.
If you want to limit Enterpret's access to certain Linear teams or projects, assign restricted permissions to the service account.
How to Use
Link Linear Work Items to Individual Feedback Records
Connect specific customer feedback to Linear work items for full traceability.
Open a Feedback record
Click Add Work Item
Enter the Linear Issue or Project title or Issue ID
Click Assign Work Item
Once linked, a Linear preview card appears in the right panel above Predictions.
Best practices:
Link feedback to an existing Linear issue if the request is already being tracked.
If you have several feedback records describing the same issue, create a Collection in Enterpret and link the Linear issue or project to that Collection instead of linking each record individually.
Use one issue or project per distinct problem or feature request. If the feedback relates to a different problem or area of work, create or link a separate issue.
Link Linear Work Items to Feeds
Connect filtered views of feedback to related Linear work items.
Open a Saved Feed or create a new Feed
Click Add Work Item
Enter the Linear Issue or Project title or Issue ID
Click Assign Work Item
Once linked, a Linear preview card appears above the Feed items.
Best practices:
Use filters to narrow down to specific areas before assigning Linear work items.
Assign Linear work items to precise, well-defined segments rather than broad categories for better tracking and clarity.
Link Linear Work Items to Themes or Sub-Themes
Connect your taxonomy to roadmap items and epics.
In Quantify, plot a Theme or Sub-theme
Click the Theme or Sub-theme on the chart
Enter the Linear Issue or Project title or Issue ID
Click Assign Work Item
Themes or Sub-themes with linked Linear work items display a Linear icon next to them.
You can also assign Linear work items to themes and sub-themes from Quantify widgets in the dashboard.
Note: Quantify itself doesn't link to Linear work items. Assignments apply only to the selected Theme or Sub-theme.
Best practices:
Use Theme-level linking for roadmap items that represent a cohesive problem area.
Avoid linking very high-level categories that span unrelated work.
Link Linear Work Items to Collections
Group related feedback and connect it to Linear work items.
Open a Saved Collection
Click Add Work Item
Enter the Linear Issue or Project title or Issue ID
Click Assign Work Item
Once linked, a Linear preview card appears above the Collection feed.
Linear Previews in Enterpret
Preview cards display:
Issues: ID, title, status, and assignee
Projects: title, lead, and status
Both include a link back to Linear
When a Linear issue/project is linked for the first time, the preview appears immediately. Subsequent updates in Linear are reflected in Enterpret in near real-time via webhooks.
Enrich Linear Issues and Projects with Enterpret
When you link an Enterpret entity (Feed, Collection, Theme/Sub-theme, or Feedback Record) to a Linear issue or project, Enterpret creates a Linear Doc attached to that work item containing:
Total unique feedback count across all linked Enterpret entities
Backlinks to all linked Enterpret entities (Feeds, Collections, Themes, Feedback Records) with direct links back to Enterpret
Frequently Asked Questions
Who can enable the Linear integration?
Only Enterpret admins and Linear workspace admins can connect via OAuth.
Can I connect multiple Linear workspaces?
Currently, one Linear workspace connection per Enterpret workspace.
Who can see linked Linear work items in Enterpret?
Everyone in Enterpret can see the linked Linear work items.
Do you write data back to Linear? What data is shared?
Yes. Enterpret creates a Linear Doc attached to issues and projects containing the total unique feedback count linked to that work item and backlinks to all linked Enterpret entities.
What fields appear in the preview card?
Issues: ID, title, status, and assignee
Projects: title, lead, and status
Can I link to both Linear Issues and Projects?
Yes. Both Linear Issues and Projects are fully supported.
Can I link multiple Enterpret objects to one Linear issue?
Yes, a single Linear issue or project can be linked to multiple Feedback records, Feeds, Themes, or Collections. We recommend keeping the assignments contextual to the Linear work item for the best experience.
Can I unlink or change a Linear issue once it's connected?
Yes, click the "×" icon next to the Linear issue to remove it.
What happens if the Linear integration is deleted or deactivated?
Enterprеt will stop showing Linear assignments and all existing links to Linear will disappear. Linear Docs previously created on linked issues and projects will remain in Linear and can be manually deleted if no longer needed.
For questions or support, reach out to [email protected]