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

Bitbucket Cloud is implementing a 100 MB limit on files included in a Git push

Starting on May 6, 2024, we will begin rolling out a 100 MB file size limit for git pushes to Bitbucket Cloud repositories.


Why are we implementing a push file size limit?

Bitbucket Cloud currently has a repository size limit of 4 GB, which puts a repository in a read-only state if exceeded and requires support intervention to reduce the repository size back below the limit. The most common reason customers exceed this limit is by pushing large files. Customers should be storing large files as Git LFS instead of their repository.

A push file size limit helps customers keep their repositories in the most performant state and below the 4 GB size limit by keeping unwanted files and/or binary files out of source control.


What can I do if I run into this limit?

If you encounter the push file size limit, you have two options:


Any files included in the push that are over 100 MB can be converted to Git LFS to track them outside of the core repository. Learn more about using Git LFS with Bitbucket Cloud.

Option 2:

If using Git LFS is not feasible, the 100 MB push file size limit can be disabled by a repository admin within the Advanced settings in Repository settings.


WARNING: If this limit is disabled, you are at risk of exceeding the 4 GB repository size limit, which will put the repository into read-only mode and require support intervention to reduce the repository size back below the limit when possible or applicable. This can cause significant disruption to your operations.


What if I already have files over 100 MB in my repository?

This limit only applies to pushes. Any files that are over 100 MB and are already in a repository will not be affected, if they are not modified and included in any pushes. If those large files are being frequently modified, we recommend converting them to LFS where practical or necessary. Learn more about converting existing repository files to Git LFS here.


ccenvcvb March 15, 2024

Looks like does not cater for large mono-repos.

Is there a switch to toggle if a repo needs to grow beyond 4GB ?

Not sure if we're close to the limit yet, just curious

Like # people like this
Rich March 15, 2024

We keep getting warnings about going over 2GB and have to contact support to run git gc to re-compress. 

They keep saying they will offer this for the user but I haven't seen the option yet. 

Like # people like this
Sam Nichols
Atlassian Team
Atlassian Team members are employees working across the company in a wide variety of roles.
March 21, 2024

Hi @ccenvcvb 

To protect platform stability, Bitbucket Cloud maintains limit of 4GB for all repositories. There is not a self serve toggle in the UI to request a repo size increase, and there are no short term plans to implement that.  If you would like expert advise for your specific use case, please reach out to our Support team, sharing your repository URL and your needs, and our team will work with you on the best possible solution.

Like # people like this
水越 直哉 April 3, 2024

「File size limits」When will this feature be implemented?

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!
April 15, 2024

@水越 直哉 "Starting on May 6, 2024..."

Andreas Rath April 18, 2024

Will there be a API call available to switch off the push limits for all git repos in an organization? 

If yes, would be great if you can post this script here. 

Comment to bitbucket team: 

I would suggest and wish if you can offer to "opt in" to this push limit rather than automatically enforcing it on all git repos. I think this is a nicer way to bring new features to your customers. Would appreciate if you think about this and discuss it internally again. Many thanks!


Log in or Sign up to comment
AUG Leaders

Atlassian Community Events