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.

    Screenshot of the main page of a repository. In the horizontal navigation bar, two tabs, labeled "Issues" and "Pull requests," are each outlined in dark orange.

  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.

    • To edit a milestone, next to the milestone you want to edit, click Edit.

      Screenshot of the list of milestones. Within the entry for the "beta release" milestone, a link, labeled "Edit," is outlined in dark orange.

  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.

    Screenshot of the main page of a repository. In the horizontal navigation bar, two tabs, labeled "Issues" and "Pull requests," are each outlined in dark orange.

  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.

Screenshot of the list of milestones for a repository. Within the entry for the "beta release" milestone, a red "Delete" link is outlined in dark orange.