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

Earn badges and make progress

You're on your way to the next level! Join the Kudos program to earn points and save your progress.

Deleted user Avatar
Deleted user

Level 1: Seed

25 / 150 points

Next: Root


1 badge earned


Participate in fun challenges

Challenges come and go, but your rewards stay with you. Do more to earn more!


Gift kudos to your peers

What goes around comes around! Share the love by gifting kudos to your peers.


Rise up in the ranks

Keep earning points to reach the top of the leaderboard. It resets every quarter so you always have a chance!


Come for the products,
stay for the community

The Atlassian Community can help you and your team get more value out of Atlassian products and practices.

Atlassian Community about banner
Community Members
Community Events
Community Groups

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.

@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:

Please guide me on , if it is possible to read/download the pullrequest attachment content using bitbucket api ?

if it is possible, please let me know - the rest api - for cloud & for server that will help in this.


@Tyler T What does it mean if i don't have the "browse to upload" link in my companies Bitbucket repo? how can i add that?

Tyler T Atlassian Team Apr 04, 2022

@Liron Burrack are you on Bitbucket Cloud? If you don't see the upload button I suggest filing a bug. The feature is available to all customers by default.

Hi @Tyler T

I found it eventually. it seems like it is only showing up when creating a pull request but when editing.

Is there a plan to make the `upload image` modal work without the 1mb limit?

@Tyler T  Is the bitbucket cloud API to upload file to pull request publicly available ? Please suggest as I can't find it in the documentation.  


Log in or Sign up to comment

Atlassian Community Events