Skip to main content
In this lesson/article we’ll explain milestones and how they help coordinate work across issues and pull requests. Milestones are a lightweight project-management feature (commonly used in GitHub) that group related issues and PRs around a single delivery objective—such as a release, sprint, or project phase. While labels describe the nature of a task, milestones answer the “when” for a collection of tasks by centralizing deadlines, progress, and scope.
The image shows a project management interface for a "beta release" milestone, with progress at 33% and overdue by 13 days. It includes open issues related to dependencies and a bug report.
Core functionalities of milestones
Make sure you link issues and pull requests to the milestone (or create them from the milestone view). The progress bar only reflects work that is associated with the milestone.
Practical tips and best practices
  • Create a milestone for each release, sprint, or major project phase to keep scope and deadlines visible.
  • Use the milestone view to create issues directly—this automatically associates them with the milestone and updates progress.
  • Regularly review overdue milestones and update due dates or rescope the work to reflect current priorities.
  • Filter and sort issues by milestone to produce status reports and to identify blockers quickly.
  • Combine milestones with labels (e.g., bug, enhancement, high-priority) for better filtering and triage workflows.
Why use milestones?
  • Visibility: Stakeholders can quickly see overall progress and what’s blocking a release.
  • Coordination: Developers and maintainers have a shared reference for delivery dates and scope.
  • Reporting: Progress bars and milestone lists simplify status reporting and retrospective analysis.
References and further reading By grouping related issues and pull requests under milestones, teams gain a clearer picture of progress, deadlines, and priorities—making release planning and sprint execution more predictable and transparent.

Watch Video