Connect Linear so each new feedback report opens an issue, with its priority, in the Linear project you choose.
3 min readUpdated 24 days ago
Before you start. You need a Linear account that can create issues, and at least one project in your Linear workspace: Rectify adds issues to a project, not straight to a team. Everyone who can open the Rectify project can connect Linear, on every plan.
With Linear connected to a project:
•
Each new feedback report opens an issue in your Linear project, in that project's team. The report's title and description become the issue's title and description, and its priority carries over.
•
The Create Linear Issue workflow step adds issues to the same project.
Issues are created as the person who connected Linear. Linear is connected per project, so to use it in another project, connect it there too.
Connect Linear
1.
Open Project settings, then Integrations.
2.
Select Linear.
3.
Select Connect. Linear opens.
2 Linear. 3 Connect.
4.
Check what Rectify asks for and approve it.
Rectify asks to read your workspace and create issues. Linear then sends you back to Linear in Integrations, now marked Connected.
Choose the Linear project
Rectify starts with the first project it finds in your workspace. To use another one:
1.
Pick it under Linear project.
2.
Select Save. You see Linear integration configured successfully.
1 Linear project. 2 Save.
If a project belongs to more than one team, issues go to the first team Linear lists for it.
How priorities carry over
Priority in Rectify
Priority in Linear
Critical
Urgent
High
High
Medium
Medium
Low
Low
Neutral
No priority
Each report is sent once, as soon as it arrives. Changes made later, in Rectify or in Linear, aren't synced either way.
Pause or disconnect Linear
To pause, turn the switch at the top of the Linear page to Off. New reports stop opening issues and the Create Linear Issue step stops working until you turn it back On.
To disconnect, select Disconnect under Disconnect Linear. It happens straight away, with no confirmation, and you see Linear integration removed successfully. Rectify forgets the connection but doesn't withdraw the access you gave it in Linear. To withdraw that too, remove Rectify from the apps you've authorized in your Linear settings.
Troubleshooting
No issues appear in Linear
Check that Linear shows On in Integrations, and that Linear project is the one you expect. Only reports that arrive after you connect are sent.
The Linear project list is empty
Your workspace has no projects yet, or your Linear account can't see them. Create a project in Linear, then come back and pick it.
A workflow run fails with "Linear project or team not configured"
Pick a project under Linear project and select Save, then run the workflow again.
A workflow run fails with "Linear integration not enabled for this project"
Linear is turned off or not connected in this project. Turn it On, or connect it, and run the workflow again.