Forums

Articles
Create
cancel
Showing results for 
Search instead for 
Did you mean: 

Pull Request Template not working

Antonio Alves
I'm New Here
I'm New Here
Those new to the Atlassian Community have posted less than three times. Give them a warm welcome!
March 24, 2026

We are using bitbucket cloud and I've created a file and folder 

.bitbucket\pull_request_template.md

following this page:
Pull Request templates in Bitbucket Cloud | Bitbucket Cloud | Atlassian Documentation

I did publish my source_branch but when I tried to create a PR the template is not showed.

I did create a simple file with only one line to test it but I haven't get any success.

Do I need to have any privileges on the repo a part from normal developer?

Tks

1 answer

0 votes
Ajay _view26_
Community Champion
March 24, 2026

Hi @Antonio Alves 

The first thing I’d check is the file path. In Bitbucket Cloud, the documented path is:

.bitbucket/pull_request_template.md

with forward slashes, not backslashes.

Your post shows:
.bitbucket\pull_request_template.md

If that is the actual path in the repo, Bitbucket won’t pick it up as the PR template.

A couple of other details from the docs:
- the template is branch-dependent
- Bitbucket uses the template file from the source branch of the PR
- if the file is not present in the source branch, the default PR description is shown instead

So I’d verify:
1. the file path is exactly .bitbucket/pull_request_template.md
2. the file exists in the source branch you’re opening the PR from
3. the branch with the template was pushed before opening the PR

I don’t believe this is primarily a permissions issue if you can already create the PR.

Antonio Alves
I'm New Here
I'm New Here
Those new to the Atlassian Community have posted less than three times. Give them a warm welcome!
March 24, 2026

Hey @Ajay _view26_ 
Thanks for the comments.
All 3 mentioned items were checked:

[x] 1. the file path is exactly .bitbucket/pull_request_template.md
[x] 2. the file exists in the source branch you’re opening the PR from
[x] 3. the branch with the template was pushed before opening the PR

I believe the path slash is system dependent (I'm using Windows) :-) 
Copied now from our website repo:

.bitbucket/pull_request_template.md

I was able to get the PR template working using the repo settings following this page:
Pull request and merge settings | Bitbucket Cloud | Atlassian Support

Tks

Like Ajay _view26_ likes this

Suggest an answer

Log in or Sign up to answer
DEPLOYMENT TYPE
CLOUD
PRODUCT PLAN
PREMIUM
TAGS
AUG Leaders

Atlassian Community Events