Skip to main content

Changing the stage of a pull request

You can mark a draft pull request as ready for review or convert a pull request to a draft.

Who can use this feature?

People with write permissions to a repository and pull request authors can change the stage of a pull request.

Draft pull requests are available in public repositories with GitHub Free for organizations and legacy per-repository billing plans, and in public and private repositories with GitHub Team, GitHub Enterprise Server, and GitHub Enterprise Cloud. For more information, see "GitHub’s plans."

Marking a pull request as ready for review

When you're ready to get feedback on your pull request, you can mark your draft pull request as ready for review. Marking a pull request as ready for review will request reviews from any code owners.

Tip: You can also mark a pull request as ready for review using the GitHub CLI. For more information, see "gh pr ready" in the GitHub CLI documentation.

  1. Under your repository name, click Pull requests.

    Screenshot of the main page of a repository. In the horizontal navigation bar, a tab, labeled "Pull requests," is outlined in dark orange.

  2. In the "Pull requests" list, click the pull request you'd like to mark as ready for review.

  3. In the merge box, click Ready for review.

    Screenshot of the merge box in a pull request. The "Ready for review" button is outlined in dark orange.

Converting a pull request to a draft

You can convert a pull request to a draft at any time. For example, if you accidentally opened a pull request instead of a draft, or if you've received feedback on your pull request that needs to be addressed, you can convert the pull request to a draft to indicate further changes are needed. No one can merge the pull request until you mark the pull request as ready for review again. People who are already subscribed to notifications for the pull request will not be unsubscribed when you convert the pull request to a draft.

  1. Under your repository name, click Pull requests.

    Screenshot of the main page of a repository. In the horizontal navigation bar, a tab, labeled "Pull requests," is outlined in dark orange.

  2. In the "Pull requests" list, click the pull request you'd like to convert to a draft.

  3. In the right sidebar, under "Reviewers," click Convert to draft.

    Screenshot of the "Reviewers" section in the right sidebar of a pull request. The "Convert to draft" link is outlined in dark orange.

  4. Click Convert to draft.

Further reading