Showing results for 
Search instead for 
Did you mean: 
Sign up Log in

It's not the same without you

Join the community to find out what other Atlassian users are discussing, debating and creating.

Atlassian Community Hero Image Collage

Add file attachments to pull requests in Bitbucket Cloud

During code review, static image files might not be adequate when a developer wants to demo their changes. Starting now, teams can attach any type of file to a pull request. No need to worry about the file size either. For example, “before and after” screen recordings can be uploaded and viewed directly in a pull request.

With this change, Bitbucket Cloud has become more integrated with the Atlassian ecosystem. Does your team also collaborate on Jira or Confluence? The Atlassian Media Picker saves your recent attachments across all three products. It also has integrations with GIPHY, Dropbox, and Google Drive.

Let’s dive in.

Add attachments to a new pull request

Click Browse to upload next to the Attachments field to open the Media Viewer.


If you have uploaded attachments before you will see them in Recent uploads area. To upload a new attachment, select a file on your local device or open one of the integrations on the navigation menu.


After uploading some attachments, create the pull request.


Updating attachments on an existing pull request

When viewing a pull request, you can add or remove attachments inside the attachment filmstrip. No need to return to the edit view.


What’s next?

From the very beginning, we were confident this feature would add value to code reviews. Beyond that, we realized it could unleash some powerful workflows.

Post attachments from build tools

A public API for pull request attachments is on the way. Right now, internal teams at Atlassian are using this feature to post visual diffs from their build tools. The same could be done with logs in text files. The possibilities are endless.

Additional context for attachments

Pull request attachments by themselves are useful, but greater flexibility and context is ideal. Your attachments will soon have information like the uploader, file metadata, and an editable description in a modal sidebar.

Start attaching today!

Give pull request attachments a spin and let us know what you think in the comment below.


This is a great feature indeed. Helps keep track of many documentations, inferences within the PR.


When can we expect a public API for POST?

Like Tyler T likes this
Tyler T Atlassian Team Nov 02, 2020

@maddy302 glad you find the feature useful! We have the public API project roadmapped for early next year.

@Tyler T Making it possible through the public API to add attachments to PRs would indeed be an awesome feature. Are there any news on when this is foreseen to be included in the public API?

Like maddy302 likes this

you say in the article "No need to worry about the file size either."


but currently it shows the limit 1MB, which is quite small with modern resolution screenshots


I could not find any file limit settings in the repo settings, can you please help with that ?



Tyler T Atlassian Team Sep 08, 2021

@dmitriy that looks like the comment attachment modal. Try using the Pull Request Attachments upload instead.

Nick Ford I'm New Here Sep 14, 2021

@Tyler T  Is there updated documentation around the Public PR Attachment API? Earlier you said there would be an update earlier this year, but I have yet to find the feature.

Like maddy302 likes this
Tyler T Atlassian Team Sep 27, 2021

Hi @Nick Ford , unfortunately we do not have any updates as this project has been de-prioritized for the moment. Please watch and follow this public issue to receive the latest updates:


Log in or Sign up to comment
Community showcase
Published in Bitbucket

New improvements to user management in Bitbucket Cloud 👥

Hey Community! We’re willing to wager that quite a few of you not only use Bitbucket, but administer it too. Our team is excited to share that we’ll be releasing improvements throughout this month of...

3,930 views 10 16
Read article

Community Events

Connect with like-minded Atlassian users at free events near you!

Find an event

Connect with like-minded Atlassian users at free events near you!

Unfortunately there are no Community Events near you at the moment.

Host an event

You're one step closer to meeting fellow Atlassian users at your local event. Learn more about Community Events

Events near you