Docs / Integrations
Linear
Sync projects and issues in real time with Linear.
Overview
Linear is the backbone of Productlane. Issues, projects, customers, and your roadmap stay in sync both ways, so your inbox, feedback, public roadmap, and changelog always reflect the current state in Linear.
Connect Linear
Sign in to Productlane with your Linear account, or connect Linear from Settings → Integrations → Linear.
Connect with an account that has admin rights in Linear for full access to teams, customers, and projects.
The connection refreshes itself, so you stay connected without re-authenticating. Disconnecting requires an admin role in Productlane.
Choose teams and a default team
Select which Linear teams are visible in Productlane. Only their issues and projects sync.
Private Linear teams are not available. Make the team public in Linear to use it.
Set a default team to speed up creating issues and projects. It is preselected in the create dialogs and used whenever an issue is created automatically.
What syncs
Two-way, in real time:
Issues - title, description, status, priority, assignee, and due date stay in sync. Create an issue in either tool and link it to a thread.
Projects - name, description, status, team, icon, and color stay in sync.
Customers - name, revenue, tier, size, status, and domains sync both ways. Creating a company in Productlane creates the matching customer in Linear.
From Linear into Productlane:
Customer requests - requests attached to a Linear issue appear on the linked Productlane feedback.
Public roadmap - your roadmap mirrors your Linear projects and their statuses.
From Productlane into Linear:
Thread backlinks - linking a thread to an issue adds an attachment on the Linear issue that points back to the conversation, with the sender, origin, and title.
Deleted projects and issues in Linear
When a project or issue is deleted in Linear, Productlane does not permanently remove it. Instead, it is moved to the Closed status and appears in the Closed section on your roadmap. This protects you from accidental data loss — if someone deletes a Linear project or issue by mistake, the linked feedback and customer requests are still visible in Productlane.
To permanently remove a closed project or issue, delete it directly inside Productlane.
Turn threads into issues
Link any thread to an existing Linear issue or project, or create a new one from the thread. Productlane records it as a customer request on the issue, along with the feedback and the contact.
Turn on Auto-create issues to file a Linear issue automatically for every incoming thread from your customer channels (widget, live chat, email, portal, Slack Connect, and more). New issues start in your default team's triage state.
Issue templates
When creating a Linear issue from Productlane, you can apply one of your Linear issue templates to prefill the new issue.
In the create issue dialog, click Template next to the team selector to browse templates. They are grouped by team, with workspace-wide templates listed separately.
Templates are read directly from Linear, so the list always matches what your team manages there.
If a team has a default template configured for its members in Linear, Productlane automatically applies that template as soon as the create issue dialog opens with that team selected, as long as you have not already picked a different template. You can always switch to another template or clear it with No template.
Applying a template can prefill the priority, labels, description, workflow state, assignee, and project. If the template has a default title, it is appended to whatever you have already typed.
Choosing a template that belongs to a different team automatically switches the team selector to that team, then applies the template's status, assignee, project, and labels once that team's data has loaded. This only works if the template's team is one of the Linear teams you have made visible in Productlane (see "Choose teams and a default team" above).
If the template's team is not visible in Productlane, the team is not switched, and Productlane shows a notice that the template's status, assignee, project, and labels were skipped.
Pick No template to clear a template you already applied.
Automations
Auto-assign to customer owner - route a thread to the workspace member who owns the Linear customer.
Auto-assign Cursor - assign new Linear issues to your Cursor agent so a fix can start before you reply. See the Cursor article.
Changelog drafts - completing a project in Linear can generate a changelog draft automatically, ready for you to review and publish.
Linear permission scope
When you connect Productlane, Linear shows the prompt "Read access to your workspace". Here is exactly what that covers and why each part is needed.
Objects Productlane reads
" Object | " Fields used |
|---|---|
" Issues | " Title, description, status, priority, assignee, due date, labels, attachments |
" Projects | " Name, description, status, team, icon, color |
" Teams | " Name, identifier, states, labels, members |
" States | " Name, type (for mapping issue status) |
" Labels | " Name, color (for display and filtering) |
" Members | " Name, avatar (for assignee display and auto-assignment) |
No billing data, private comments, or objects outside the selected teams are accessed.
Team scope
If you choose Only select teams during setup, Productlane syncs only those teams. Issues, projects, states, labels, and members from teams you did not select are never fetched.
If you choose All teams, every public team in your Linear workspace is included. Private teams are excluded regardless of this setting.
Write access
In addition to reading, Productlane writes back to Linear in two ways:
Attachments - adds a backlink on an issue when you link a thread to it.
Issues and projects - creates or updates issues and projects when you act from Productlane (for example, creating an issue from a thread or syncing a status change).
Was this helpful?