Linear Integration
Connect ProductBridge to Linear to link feedback posts with issues, create Linear issues directly from feedback, and automatically update post status when linked issues move through your Linear workflow.
Overview
The Linear integration is a two-way tracker link between ProductBridge feedback and Linear issues. It does not import issues as feedback — instead, it gives your product and engineering teams a clean handoff once a piece of feedback is ready to be acted on.
Once connected, you can:
-
Search Linear issues from any feedback post and link them in one click
-
Create a new Linear issue directly from a feedback post — complete with team and workflow-state pickers
-
Auto-sync post status — when a linked issue's workflow state changes in Linear, ProductBridge updates the corresponding post status based on rules you define
-
Notify voters automatically when a post status changes because of a linked issue update
The sync runs in real time over webhooks. There is nothing to poll, no manual refresh.
Prerequisites
-
A Linear workspace where you can authorize applications
-
A ProductBridge organization with at least one feedback board and configured post statuses
-
A user with Owner-level admin permissions in ProductBridge to install integrations
Connect Linear
Open the Integrations page
Sign in to your ProductBridge dashboard and click Connect Sources in the sidebar, then select Linear from the Project Management section.
Click Connect Linear
On the Linear integration page, click Connect Linear. ProductBridge starts the Linear OAuth flow and redirects you to Linear's authorization screen.
Authorize ProductBridge in Linear
On Linear's authorization screen, review the requested access and approve it for your workspace.
Use a service account rather than a personal account so the connection persists if team members leave.
Confirm the connection
After you approve, Linear redirects you back to ProductBridge. The integration status updates to Connected and the page shows the connected workspace and the disconnect option.
Behind the scenes, ProductBridge encrypts and stores the access token and sets up a webhook so Linear can deliver issue updates in real time.
Link a feedback post to a Linear issue
Once connected, every feedback post in your dashboard gets a Linear Issues section in the post detail view.
Open a feedback post
Click any post in the Feedback view to open the post detail panel. Scroll the right sidebar to find the Linear Issues section.
Click Link
Click the Link button next to Linear Issues. A dialog opens with two tabs: Search and Create.
Choose how to link the issue
Use the tab that fits how you usually work in Linear.
Type any text to search across issues in your workspace. Each result shows the issue identifier (for example ENG-142), current state, and title. Click any result to link it instantly.
Pick a team, then optionally a starting workflow state for that team, and fill in a title and description. ProductBridge creates the issue in Linear and links it to the post in one step.
Verify the link
The linked issue appears in the post's Linear Issues section with its identifier and current state. From there you can open it in Linear or unlink it.
Status sync rules
Linking is most powerful when Linear state changes flow back into ProductBridge automatically. Status sync rules translate Linear workflow states into ProductBridge post statuses.
A rule answers three questions:
-
When a linked Linear issue changes to workflow state X
-
Should the post change to a specific ProductBridge status (for example, Planned → In Progress → Complete)?
-
And should we notify everyone who voted for this post?
If a post has multiple linked issues, you also pick whether the rule fires when any issue reaches the trigger state, or only when all issues do.
Create a rule
Open the Linear settings page
Go back to Connect Sources > Linear. Below the connection details, you'll see the Rules section.
Click Create New Rule
Click Create New Rule. A sentence-style builder appears so you can read the rule in plain English as you build it.
Build the rule
Pick the values left to right:
| Field | What it does |
|---|---|
| any / all | Whether the rule fires when any linked Linear issue hits the trigger state, or only when all do |
| Linear state | The workflow state from Linear that triggers the rule (e.g. In Progress, Done) — populated from your teams' real workflow states |
| Post status | The ProductBridge feedback status the post should change to |
| Notify / Do not notify voters | Whether to send in-app and email notifications to voters when the rule fires |
Workflow states in Linear are defined per team. The dropdown merges states from all teams in your workspace, so identically named states (like Done) match across teams.
Save the rule
Click Create. The rule appears in the list and is active immediately. New Linear state changes that match it start syncing right away.
How rule evaluation works
When a linked issue's state changes in Linear:
-
Linear sends an issue update webhook to ProductBridge
-
ProductBridge finds every feedback post that links to that issue
-
For each rule on the integration, it checks whether the any/all condition is satisfied
-
If a rule matches, the post status is updated and (optionally) voters are notified
Rules are evaluated independently per post, so a single Linear state change can update many posts at once.
Behavior to expect
| Action in Linear | Effect in ProductBridge |
|---|---|
| State change on a linked issue | Linked issue badge on the post updates; rules evaluated; notifications fired if configured |
| Action in ProductBridge | Effect in Linear |
|---|---|
| Link an existing issue | A reference is stored on the feedback post; nothing changes inside Linear |
| Create an issue from a post | A new issue appears in the chosen team with the title and description you provided |
| Unlink an issue | The reference is removed; the Linear issue itself is not deleted or modified |
| Disconnect the integration | Syncing stops; existing post-issue links remain on the post but stop receiving status updates |
Disconnect Linear
To stop syncing:
Go to the Linear integration page
Open Connect Sources > Linear and click Disconnect.
Confirm disconnection
ProductBridge marks the integration as disconnected so no new syncs run, and leaves the existing per-post issue links in place — your feedback posts keep their reference to the Linear issue even after disconnect, so you don't lose history. They simply stop receiving status updates.
To revoke ProductBridge from inside Linear as well, remove it under Linear Settings > API > Applications — Linear cleans up the associated webhook automatically when the app is revoked.