Pull Request Template Builder
Generate GitHub and GitLab pull request templates with customizable sections, checklists, and presets.
About This Tool
The Pull Request Template Builder is a free browser-based tool that helps
development teams create consistent, well-structured pull request templates in
Markdown. Whether you use GitHub's .github/pull_request_template.md or
GitLab's .gitlab/merge_request_templates/ directory, this tool generates
templates tailored to your team's workflow.
Choose from six presets -- Minimal, Standard, Detailed, Bug Fix, Feature, and Hotfix -- or build a custom template by toggling individual sections on and off. Each section (Description, Type of Change, Checklist, Screenshots, Testing, Related Issues) is fully configurable. You can add custom checklist items specific to your project, such as "Update API docs" or "Run migration script."
The generated Markdown includes GitHub-flavored checkboxes (- [ ] / - [x]),
HTML comment placeholders to guide contributors, and a before/after screenshot
table. The live preview panel shows how the template will render on GitHub or
GitLab, so you can review formatting before committing the file.
If you work with Git workflows, you might also find the GitHub Actions Builder useful for creating CI workflow files, or the Git Commit Message Generator for enforcing Conventional Commits. For general Markdown editing, try the Markdown Preview tool.
All processing runs entirely in your browser. No data is ever sent to any server. Your template content stays private and local.
How to Use
- Select a Platform (GitHub or GitLab) to set the correct file path hint.
- Choose a Template preset (Minimal, Standard, Detailed, Bug Fix, Feature, or Hotfix) to auto-configure sections and checklists.
- Toggle individual Sections on or off using the checkboxes in the Sections panel.
- Fill in the Description, Testing, and Related Issues fields with your project-specific instructions.
- Check the relevant Type of Change boxes and Checklist items to pre-fill the template.
- Add Custom Checklist Items by typing in the input field and pressing Enter or clicking the + button.
- Switch between Markdown and Preview tabs to see the raw output or rendered result. Click Copy or press Ctrl+Shift+C to copy, or click Download to save the file.
Popular PR Template Examples
FAQ
Where do I save the generated template file?
For GitHub, save it as `.github/pull_request_template.md` in your repository root. GitHub will automatically use it as the default template when creating new pull requests. For GitLab, save it in `.gitlab/merge_request_templates/` directory (e.g., `.gitlab/merge_request_templates/Default.md`).
Can I have multiple PR templates?
GitHub supports multiple templates by placing them in `.github/PULL_REQUEST_TEMPLATE/` directory and using query parameters to select them. GitLab natively supports multiple templates -- just add multiple `.md` files in `.gitlab/merge_request_templates/`. This tool generates a single template at a time, but you can generate multiple and save them with different filenames.
What are the HTML comments in the template for?
HTML comments (`<!-- ... -->`) are invisible in the rendered Markdown on GitHub/GitLab but visible when editing. They serve as instructions or hints for contributors filling out the PR, helping them understand what information to provide in each section.
Can I customize the checklist items?
Yes. In addition to the default checklist items (code style, self-review, documentation, tests, etc.), you can add custom items using the input field at the bottom of the Checklist section. Click the X button to remove any custom item.
What is the difference between the template presets?
Minimal includes only Description and Related Issues. Standard adds Type of Change, Checklist, and Testing. Detailed includes all sections plus custom checklist items. Bug Fix and Feature are standard templates with pre-checked change types. Hotfix is a streamlined template for urgent fixes.
Is my data safe?
Yes. All template generation runs entirely in your browser using JavaScript. No data -- including your template content, checklist items, or any text you enter -- is ever sent to any server. You can verify this by checking the Network tab in your browser's developer tools.
Does the preview match how GitHub/GitLab renders Markdown?
The preview provides an approximate rendering. GitHub and GitLab have slightly different Markdown renderers with unique CSS styling, so minor visual differences are expected. The raw Markdown output is fully compatible with both platforms.
Related Tools
Issue Template Builder
Build GitHub and GitLab issue templates visually. Generate YAML issue forms or classic Markdown templates with custom sections, labels, and assignees.
README Generator
Generate professional README.md files from a simple form. Choose templates, add badges, sections, and download instantly.
CONTRIBUTING.md Generator
Generate professional CONTRIBUTING.md files for open source projects with templates for contribution types, commit formats, and PR processes.
Markdown Preview
Write and preview Markdown in real time with GFM support, tables, task lists, and HTML export.
GitHub Actions Workflow Builder
Build GitHub Actions workflow YAML files visually. Configure triggers, jobs, steps, matrix strategies, and secrets references.