How to Set Up OKRs in Linear
OKRs give product teams a shared language for what matters this quarter, but most PM tools treat them as an afterthought. Linear does not have a dedicated OKR module, yet its project hierarchy, label system, and filtered views make it surprisingly capable as an OKR tracker when configured intentionally.
This guide walks you through setting up a repeatable OKR structure in Linear that connects high-level objectives to the actual issues your team ships against. You will create a labeling taxonomy, build filtered views for leadership check-ins, and establish a cadence for scoring key results without leaving the tool your engineers already live in.
Step-by-step guide
Create a dedicated OKR team or project area
In Linear, create a new project called 'Q4 2026 OKRs' (or the relevant quarter) under your primary team. Set the project status to 'In Progress' and add a target date matching your quarter end. This project becomes the container that links every objective back to a single trackable entity.
- Navigate to your team and click 'New Project'
- Name it with the quarter and year for easy filtering later
- Set the project lead to whoever owns the OKR review cadence
Define objectives as project milestones
Each objective becomes a milestone within the OKR project. Milestones in Linear support descriptions and target dates, which map naturally to the qualitative nature of objectives. Write each objective as a directional statement — 'Improve activation rates for new signups' — not a metric.
- Open the project and navigate to the Milestones tab
- Create one milestone per objective (typically 3-5 per quarter)
- Add a one-sentence description clarifying what success looks like qualitatively
Create key results as issues with measurable acceptance criteria
Under each milestone, create issues that represent individual key results. The issue title should state the metric and target — 'Increase 7-day retention from 32% to 45%'. Use the issue description to document the baseline, data source, and measurement method so scoring is unambiguous at quarter end.
- Create 2-4 issues per milestone, each representing one key result
- Tag each with a 'Key Result' label for filtering
- Set priority to reflect the relative importance within the objective
Build a label taxonomy for OKR categorization
Create a label group called 'OKR' with child labels: 'Objective', 'Key Result', and optionally 'Initiative'. Apply 'Key Result' to your KR issues and 'Initiative' to any downstream work items that contribute to a KR. This taxonomy lets you slice any Linear view by OKR relevance without restructuring your existing workflow.
- Go to Settings > Labels and create the 'OKR' label group
- Assign colors that stand out — red for Objective, blue for Key Result, green for Initiative
- Document the labeling convention in your team's workspace description
Link shipping work to key results using sub-issues or relations
For each key result issue, link the actual engineering and design issues that contribute to moving the metric. Use Linear's 'relates to' or parent/sub-issue relationships so progress on shipping work visually rolls up to the key result. This is where OKRs stop being a slide deck and start being connected to real output.
- Open a key result issue and use Cmd+Shift+L to add relations
- Choose 'is blocked by' for hard dependencies or 'relates to' for contributing work
- Review the relation graph periodically to spot unlinked work
Create custom views for OKR check-ins
Build a saved view filtered to the 'Key Result' label, grouped by milestone (objective), and sorted by status. This becomes your weekly OKR review dashboard. Add a second view filtered to 'Initiative' issues grouped by assignee to see who is working on what across objectives without switching context.
- Click 'Views' in the sidebar and create a new custom view
- Set filter: Label is 'Key Result', Project is your OKR project
- Save and pin it to your sidebar for one-click access during standups
Establish a scoring and review cadence
At the end of each month or quarter, update each key result issue with a score (0.0 to 1.0) in a comment or custom field. Move completed KRs to 'Done' and partially achieved ones to 'Cancelled' with a scoring note. Archive the quarterly project and duplicate the structure for the next quarter to maintain historical records.
- Schedule a recurring calendar event for OKR scoring sessions
- Use the issue comment thread to document the final metric value and score
- Create next quarter's project by duplicating the current one and resetting milestones
Common mistakes
Treating key results as tasks instead of outcomes
A key result should measure a change in a metric, not describe work to be done. 'Launch redesigned onboarding flow' is an initiative, not a key result. 'Increase onboarding completion rate from 40% to 65%' is a proper KR. If your key results do not have numbers, they belong in the initiative layer.
Creating too many objectives per quarter
More than five objectives dilutes focus and makes check-ins exhausting. Linear's milestone view gets cluttered fast. Stick to three objectives per team per quarter, each with two to four key results. If everything is a priority, nothing is.
Forgetting to link initiatives to key results
Unlinked work means your OKR dashboard shows stale progress even though the team is shipping. Make linking a KR a required step in your issue creation template. Without this connection, OKRs become a parallel reporting system that nobody trusts.
Never updating scores mid-quarter
Waiting until quarter end to check OKR progress defeats the purpose of having measurable goals. Use your monthly check-in view to update confidence levels. Linear's comment threads on each KR issue are the right place to capture 'we are at 60% confidence on this one because signups dropped in week 3.'
Tips
Use Linear's project updates feature to write a brief weekly OKR status — it timestamps the narrative alongside the data.
Create a 'Stretch' label for ambitious key results so reviewers know which KRs were intentionally set above 70% difficulty.
Archive previous quarter OKR projects rather than deleting them — they become a searchable history of what the team committed to and achieved.
Set up a Slack notification for when key result issues move to 'Done' so leadership gets real-time visibility without asking for updates.
How Vantage helps
Vantage connects your OKR-linked key results directly to PRD generation, so when you define a new project the system already knows which objectives it supports. As your team scores key results in Linear, Vantage's bi-directional sync surfaces progress alongside the product context that drove each initiative, eliminating the gap between strategy tracking and execution.