Founding price: the first 100 buyers get Pro for life at $24 once (then $39).Founding: Pro for life $24 Get notified →
Free templates

Pull request template (GitHub, with a QA checklist)

A pull request template is the cheapest QA step you can add: every PR arrives with what changed, how to test it and a short checklist. This is the PR template from our Bug Report & QA Kit, free to copy.

Quick answer

Save the template below as .github/pull_request_template.md and merge it to the default branch; GitHub then pre-fills every new PR body with it. For several templates, use a .github/PULL_REQUEST_TEMPLATE/ folder and the template query parameter (GitHub Docs, checked 23 October 2026).

The template

.github/pull_request_template.mdCommit as-is
## What and why
<!-- One or two sentences. Link the issue: Fixes #123 -->

## How to test
1.
2.

## Screenshots or recording
<!-- Before / after for any UI change. A 30-second recording beats five screenshots. -->

## QA checklist
- [ ] Tested the happy path and at least one error path
- [ ] Tested on the smallest supported screen (or not UI)
- [ ] Tests added or updated (or explained why not)
- [ ] No secrets, personal data or debug logging added
- [ ] Feature flag / config change documented (or none)
- [ ] Migration is reversible or rollback plan written (or no migration)
- [ ] Release note line written below (or internal only)

## Release note
<!-- One line in user language, e.g. "CSV exports now include all rows for large projects." -->

Why each section is there

Other hosts: GitLab uses .gitlab/merge_request_templates/; Azure DevOps and Bitbucket have their own settings for PR descriptions. The Markdown above works in all of them.

Record the video part

Record the before and after of a UI change and drag the file into the PR description. Bobbin is a free Chrome extension that records your screen, a window or a tab with your microphone and an optional webcam bubble. No account, no watermark, no time limit, and nothing is uploaded: the file stays on your computer.

  1. Click the Bobbin icon in Chrome's toolbar and choose Record screen, window or tab.
  2. Pick your microphone and turn on the camera if you want the webcam bubble.
  3. Press Start recording, choose what to share in Chrome's picker, and wait for the 3-second countdown.
  4. Pause with Alt+Shift+P, stop with Alt+Shift+S, then press Download to save the file.

To keep other tabs and notifications out of it, share just the Chrome tab (the webcam bubble appears only in screen and window recordings). Bobbin saves MP4 where your browser supports it (Chrome 126 or newer), WebM otherwise, and tells you which it used.

File size: our 60-minute 1080p test came to about 246 MB (roughly 4 MB a minute) on a simple synthetic screen; busy real screens can be larger, so a 1–2 minute clip is usually small enough to attach.

From The Bug Report & QA Kit

The kit also has 9 GitHub issue forms and a script that creates the matching labels. The full kit: 10 bug templates for GitHub, Jira, Linear and Markdown, 9 release checklists (126 checks), the severity guide, 8 bug-video scripts and trackers.

See the QA kit ($15, one-time) PDF + ZIP · 7-day refund · more free samples on the page

Checked on 23 October 2026 from their own pages: GitHub Docs: Creating a pull request template. Features change; check the linked page before you rely on it.

Loom, Vidyard, Tella, Tango, Screencastify, Screenity, Zoom and Slack are trademarks of their respective owners. Bobbin is not affiliated with them. Prices and plan limits from their public pages as of 22 Oct 2026.

Frequently asked questions

Where do I put a pull request template on GitHub?

Name it pull_request_template.md and put it in the repository root, docs/ or .github/. It is used once it is on the default branch.

Can I have more than one PR template?

Yes: put them in a PULL_REQUEST_TEMPLATE/ folder and choose one with the template query parameter in the PR URL.

What should a pull request template include?

What changed and why (with the issue link), how to test it, screenshots or a recording for UI changes, a short QA checklist and a release-note line.

Record your screen and camera. Keep the file.

Free, no account, no watermark, no time limit. Saves an MP4 on your computer.

Launching on the Chrome Web Store soon. The Install page has the link as soon as it is live.