Pull Request templates in Bitbucket Cloud
Platform Notice: Cloud Only - This article only applies to Atlassian apps on the cloud platform.
Summary
Sometimes, as a user, it's a requirement to configure the default pull request description directly through Git rather than using Bitbucket's Pull Request description field, or even have a default description based on the current source branch.
This page describes how you can create a file in your Bitbucket repository that will allow you to configure the default pull request description for Bitbucket repositories.
Solution
Environment:
Bitbucket Cloud
How to use the feature:
Either through Bitbucket Cloud's UI or through Git, create a new file with the exact path described below:
.bitbucket/pull_request_template.mdIn this file, type in the default PR description that you wish.
ℹ️ This file supports markdown.
Commit the file to your Bitbucket Cloud repository.
⚠️ It's important to note that the pull_request_template.md file is branch-dependent, meaning that the description used in your PRs will be the one in the source branch.
If the .bitbucket/pull_request_template.md file is not present in the source branch, then the default description will appear in your pull request.
If there is a .btibucket/pull_request_template.md file in both the source and destination branches, the description from the file in the source branch will be used.
Was this helpful?