Free, no signup

GitHub Pull Request Template

Pick the sections your team needs and copy a ready pull_request_template.md. Or start from one of five examples below.

Pull request template builder

Sections

What the PR changes and why.

"Closes #123" closes the issue when the PR merges into the default branch.

Bug fix, feature, breaking change, docs, refactor.

Steps a reviewer can follow.

Before and after, for UI changes.

One line for customers, ready for the changelog.

What breaks and how to migrate.

Tests, docs, self-review.

Save the result as .github/pull_request_template.md and merge it into your default branch. Every new pull request will open with it.

pull_request_template.md

## Summary

<!-- What does this PR change, and why? Two or three sentences. -->

## Related issue

<!-- "Closes #123" closes the issue when this PR is merged into the default branch. -->
Closes #

## Type of change

- [ ] Bug fix
- [ ] New feature
- [ ] Breaking change
- [ ] Documentation
- [ ] Refactor or chore

## How to test

<!-- Steps a reviewer can follow to check the change. -->
1.
2.
3.

## Release note

<!-- One line for customers, in plain words: what they can do now, or what is fixed.
Write "none" if customers will not notice this change. -->

## Checklist

- [ ] I reviewed my own code
- [ ] Tests cover the change
- [ ] Docs are updated where needed

Text inside <!-- --> is a hint for the author. GitHub does not show it once the pull request is opened.

How to add a pull request template to GitHub

  1. Create a file named pull_request_template.md. GitHub reads it from three places: the repository root, a docs/ folder, or the hidden .github/ folder. Most teams use .github/pull_request_template.md.
  2. Paste your template and commit the file.
  3. Merge it into the default branch. Templates only work from the default branch, so a template on a feature branch does nothing yet.
  4. Open a new pull request. The description box now starts with your template.

Multiple templates

Put one file per template in a PULL_REQUEST_TEMPLATE/ folder, then pick one with the template query parameter when you open the pull request:

.github/
  PULL_REQUEST_TEMPLATE/
    feature.md
    bug_fix.md

https://github.com/OWNER/REPO/compare/main...my-branch?quick_pull=1&template=bug_fix.md

Source: GitHub Docs, creating a pull request template.

5 pull request template examples

Copy one as it is, or mix sections. Short templates get filled in. Long ones get deleted.

1. Minimal pull request template

For a solo developer or a small team that wants a little structure and no friction.

## What and why

<!-- What does this PR change, and why? -->

Closes #

## How to test

1.

2. Standard team template

For a product team with code review. Covers the questions reviewers ask most.

## Summary

<!-- What does this PR change, and why? Two or three sentences. -->

## Related issue

Closes #

## Type of change

- [ ] Bug fix
- [ ] New feature
- [ ] Breaking change
- [ ] Documentation
- [ ] Refactor or chore

## How to test

1.
2.

## Screenshots

<!-- Before and after, for UI changes. -->

## Checklist

- [ ] I reviewed my own code
- [ ] Tests cover the change
- [ ] Docs are updated where needed

3. Open source contribution template

For public repositories where first-time contributors open pull requests.

Thanks for contributing!

## Description

<!-- What does this PR do? Link the issue it fixes, for example "Fixes #42". -->

## Checklist

- [ ] I read CONTRIBUTING.md
- [ ] This PR targets the main branch
- [ ] I added or updated tests
- [ ] `npm test` passes locally
- [ ] I updated the documentation if behavior changed

## Notes for reviewers

<!-- Anything you are unsure about, or want a second opinion on. -->

4. Template with a release note for the changelog

For teams that publish release notes or a changelog. The author writes the customer-facing line while the change is fresh.

## Summary

<!-- What changed and why, for reviewers. -->

## Release note

<!-- One line for customers, in plain words. What can they do now, or what is fixed?
Write "none" if customers will not notice this change. -->

## Breaking changes

<!-- What stops working, who is affected, how to migrate. Delete if none. -->

## How to test

1.

5. Bug fix template

Use it as one of several templates (see "Multiple templates" below) so bug fixes get the details they need.

## Bug

<!-- What went wrong, for whom, and since when. Link the issue. -->
Fixes #

## Cause

<!-- Why it happened. -->

## Fix

<!-- What this PR changes to fix it. -->

## How to verify

1.

## Regression test

- [ ] Added a test that fails without this fix

Frequently asked questions

Where do I put a pull request template on GitHub?

Name the file pull_request_template.md and put it in the repository root, in a docs/ folder, or in the hidden .github/ folder. The .github/ folder is the usual choice because it keeps the root clean.

Can a repository have more than one pull request template?

Yes. Create a PULL_REQUEST_TEMPLATE/ folder inside .github/, the root or docs/, and put one Markdown file per template in it. To use one, add the template query parameter to the compare URL, for example ?quick_pull=1&template=bug_fix.md.

Why is my pull request template not showing up?

Templates only work once they are merged into the repository's default branch. Also check the file name (pull_request_template.md) and the folder. If you use a PULL_REQUEST_TEMPLATE/ folder, GitHub does not pick one automatically: you choose it with the template query parameter.

Can I set one pull request template for every repository?

Yes. GitHub lets you create default community health files, including a pull request template, for an organization or a personal account. Repositories that have their own template keep using it.

Why add a release note section?

The author knows best what a change means for customers, and writing one line takes a minute while the work is fresh. Later, whoever writes the changelog or release notes starts from those lines instead of reading every diff.

Writing the commits too? Try the free commit message generator. Turning merged pull requests into release notes? Start from the release notes template.

Good pull requests make good release notes

ShipTell reads the titles, descriptions and labels of your merged pull requests and drafts customer-friendly release notes. The better the PR description, the better the draft.

Start a 7-day free trial

More free tools

Release Notes Template

Six release notes formats to copy, plus a builder that outputs Markdown or plain text.

Release Notes Preview

Paste your GitHub commits and get formatted release notes in Markdown or HTML.

Changelog Entry Writer

Paste a PR title or commit message and get a changelog entry customers understand.

Commit Message Generator

Describe the change in plain English and get a conventional commit message.

Product Update Email

Paste your release notes and get an update email with a subject line and grouped changes.

Feature Request Template

Expand a one-line idea into a feature request with a user story and acceptance criteria.

Customer Support Email Generator

Ready-to-send support replies for 20 common situations, in five tones.

See all free tools