Skip to main content

Creating and editing milestones for issues and pull requests

You can create a milestone to track progress on groups of issues or pull requests in a repository.

  1. On GitHub.com, navigate to the main page of the repository.

  2. Under your repository name, click Issues or Pull requests. Issues and pull requests tab selection

  3. Next to the search field, click Milestones.

    Screenshot of the list of issues for a repository. Above the list, a button, labeled with a signpost icon and "Milestones," is outlined in dark orange.

  4. Choose one of these options:

    • To create a new milestone, click New Milestone. New milestone button
    • To edit a milestone, next to the milestone you want to edit, click Edit. Edit milestone option
  5. Type the milestone's title, description, or other changes, and click Create milestone or Save changes. Milestones will render Markdown syntax. For more information about Markdown syntax, see "Basic writing and formatting syntax."

Deleting milestones

When you delete milestones, issues and pull requests are not affected.

  1. On GitHub.com, navigate to the main page of the repository.

  2. Under your repository name, click Issues or Pull requests. Issues and pull requests tab selection

  3. Next to the search field, click Milestones.

    Screenshot of the list of issues for a repository. Above the list, a button, labeled with a signpost icon and "Milestones," is outlined in dark orange.

  4. Next to the milestone you want to delete, click Delete. Delete milestone option

Further reading