How to Create Epics in Linear (Step-by-Step Guide)
Linear uses "Projects" as the equivalent of epics — containers for related issues that span multiple cycles. Projects in Linear are more powerful than traditional epics: they have their own status, start and target dates, and progress tracking, and they appear natively on the Linear Roadmap view without additional configuration.
This guide covers creating Linear Projects (epics), linking issues, tracking progress with cycles, and connecting projects to the roadmap.
Step-by-step guide
Create a new Project
In Linear, navigate to your Team in the sidebar and click "Projects." Click "New Project" and give it a name that describes the epic outcome, such as "SSO Integration" or "Checkout V2." Add a description explaining the goal and link to the PRD. Set the Lead (owner), Status, Start Date, and Target Date.
Set the project status
Linear Projects have statuses: Backlog, Planned, In Progress, Paused, Completed, Cancelled. Set the project to "Planned" when requirements are defined but work has not started. Move to "In Progress" at the start of the first cycle where work is committed. This status drives the roadmap view.
Create issues inside the project
From within the project, click "Add issue" to create stories directly linked to the project. Issues created this way automatically appear in the project's issue list. You can also link existing backlog issues to the project by opening the issue and selecting the project in the "Project" field on the right sidebar.
Assign issues to cycles
Linear Cycles are the equivalent of sprints. Open individual issues inside the project and assign them to the current or upcoming cycle using the "Cycle" field. This connects epic-level planning (project) to sprint-level execution (cycle) — the two remain linked so you can see both views simultaneously.
Track progress on the project detail view
Open the project to see the progress bar showing completed issues versus total, a timeline view of issues, and a breakdown by assignee. The "Scope" chart shows how many issues are in each status. Use this view in sprint reviews to assess whether the epic will complete on schedule.
View the project on the roadmap
Navigate to the Roadmap view (available at workspace or team level). Each project appears as a horizontal bar on the timeline. Drag bars to adjust dates. Use the filter controls to show only active projects or filter by team. Share the roadmap URL with stakeholders for a read-only roadmap view.
Mark the project complete
When all issues in the project are resolved, update the project status to "Completed." Linear archives completed projects automatically after 30 days. Before archiving, add a "What we shipped" summary to the project description so the context is preserved for future reference.
Common mistakes
Creating projects without target dates
A Linear project without a target date does not appear on the roadmap timeline. Always set both a start date and a target date when creating the project, even if dates are approximate.
Adding all issues at creation time
Creating 50 issues in a project before any work starts creates overwhelming backlogs. Start with 5-10 well-defined issues for the first cycle and add more as the project progresses and scope becomes clearer.
Confusing projects with cycles
Projects are epics (what you are building). Cycles are sprints (when you are building it). Issues can be in a project AND a cycle simultaneously. Do not use cycles as epics — they are time-bounded containers, not feature containers.
Tips
Use Linear project updates (the "Updates" tab) to post weekly progress notes visible to the whole team
Set up Slack notifications for project status changes so stakeholders see updates without checking Linear
Use project "Milestones" (a sub-feature in Linear Projects) to mark key deliverable checkpoints within the epic
Link related projects using the "Related Projects" field to surface dependencies between epics
How Vantage helps
Vantage integrates directly with Linear. When you generate tickets from a PRD in Vantage, tickets are pushed to Linear with dependency links intact. Related tickets are automatically grouped into Linear Projects, giving you an epic structure that reflects the PRD without manual organization.