Skip to main content

Linear integration

Update your goals automatically with projects, teams, issues, and views from Linear.

ℹ️ Available on Supreme.

Connect Linear to Perdoo to update your goals with the work your product and engineering teams do in Linear. Link a KPI, Key Result, or Initiative to a project, team, issue, or view, and track issues or estimate points.

Once connected, Perdoo updates the goal for you as often as its sync frequency says. For more about progress drivers, see Progress drivers.


Connect Linear

  1. Find Linear and click Enable (1).

  2. Click Connect and then Authorize.

  3. Click Finish.

Superadmins can also connect Linear in Configure > Integrations. After you connect it, click Settings to choose whether your connection is private or shared with everyone.


Update a goal with Linear

  1. Open the KPI, Key Result, or Initiative. To set it up while you add a goal, open Advanced options.

  2. In the Details panel, click Progress driver.

  3. Select Integration and choose Linear.

  4. Select your Connection.

  5. Choose a Source type: Project, Team, Issue, or View. For a project, you can also pick a Milestone.

  6. Choose how to Track progress by: Issues (count), Estimate points (sum), Issues completed (count), Estimate points completed (sum), Issues completed (percentage), or Estimate points completed (percentage).

  7. Check the preview.

  8. Click Save & Sync now.


Good to know

How often does Perdoo fetch the latest value?

As often as the goal's sync frequency says, for example daily or weekly. Every sync adds a progress update, even if the value hasn't changed. To update sooner, click Update on the goal.

What happens if the connection stops working?

You get an email, and the goal shows a red connection error. Reconnect Linear in Personal settings > Integrations.

Can others update a goal that uses my private connection?

Yes. Anyone who can update the goal can fetch the latest value, but only you can change the connection's settings.


Need help?

Start a live chat with our Support team by clicking the question mark at the left or right bottom of your screen.

Did this answer your question?