How to Fix Linear Project Roadmap Not Showing Milestones

In this tutorial, you'll learn about How to Fix Linear Project Roadmap Not Showing Milestones. We cover key concepts, practical examples, and best practices.

Linear roadmaps provide a high-level timeline view of projects and milestones. When the roadmap does not show expected milestones, the milestones were not added to projects, the roadmap view filters exclude them, or the projects are in the wrong status.

The Problem

You open the Roadmap view and expected projects or milestones do not appear. Other team members see different data on the same roadmap.

Wrong approach — manually tracking milestones in a separate document.

The Fix

Ensure projects have milestones created:

1. Open the project
2. Click "Milestones" tab (or "Add milestone")
3. Create milestones with names and target dates
4. Milestones appear on the roadmap as diamond markers

If milestones exist but do not appear on the roadmap:

1. Check the roadmap view filters (top of the page)
2. Ensure the project's team is included in the filter
3. Check the date range — milestones outside the visible range are hidden
4. Adjust the time range to show all months

For project status affecting roadmap visibility:

1. Projects in "Backlog" or "Cancelled" status do not appear on the roadmap
2. Change project status to "Planned," "Active," or "Paused"
3. Completed projects show by default but can be filtered out

Expected output:

Roadmap shows all projects with their milestones
Milestone dates are accurate and reflect project plans
Project bars span from start date to target date

Prevention Tips

• Create milestones for every major project deliverable
• Use "Active" or "Planned" status for projects that should appear on the roadmap
• Review the roadmap weekly and update milestone dates as plans change
• Use the "Quarter" view for high-level roadmap reviews with stakeholders
• Filter roadmap by team or project group for focused planning sessions

Common Mistakes with project roadmap

1. Non-exhaustive pattern matches that compile with warnings then crash at runtime
2. Misunderstanding that String is [Char] with poor performance for large text operations
3. Using foldl instead of foldl' causing stack overflow on large lists

These mistakes appear frequently in real-world LINEAR code. DodaTech's contributors have identified these patterns through analysis of open-source projects and production systems.

Practice Exercise

Write a pure function that safely divides two integers using Maybe, then test it with edge cases like division by zero and negative numbers.

This exercise reinforces the concepts covered in this guide. Try implementing it before checking online solutions.

FAQ

Related: DodaTech's Roadmap Health Dashboard aggregates all Linear roadmaps, tracks milestone completion rates, and identifies projects at risk of missing their target dates. Use with DodaZIP for backup.