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

Do submodules count agains the repository size limit?

Thomas Van Sundert April 4, 2018


We have a repo that is currently over the 2GB size limit.


But most of the large files are in a submodule and not in the parent repo itself.

So it seems the size of submodules is added to a repo's size limit, is this correct?


thanks for the info,


2 answers

0 votes
Leo Tohill March 20, 2024

(6 years later...)

I'm pretty certain that @Daniel Eads _unmonitored account_ answer is not correct. 


The submodule feature is a link between two repos. The feature allows the workspace of the submodule repo to appear as a folder inside the workspace of the parent repo. 


A submodule repo is a repo like any other.  You can use it like any other repo, independently of the referrer, if you want to. The only thing that makes it a submodule is the link from a referring repo.  



0 votes
Daniel Eads _unmonitored account_
Rising Star
Rising Star
Rising Stars are recognized for providing high-quality answers to other users. Rising Stars receive a certificate of achievement and are on the path to becoming Community Leaders.
April 4, 2018

Hi Thomas,

That's my understanding after reading how git stores submodules - locally they are subdirectories of the parent repo but let you have commits tracked separately. On disk though (and for Bitbucket), they would count against the size of the parent.

If you haven't already started down this road, Bitbucket supports Git LFS that should help take care of the large files. Documentation for enabling it here. Files in Git LFS don't count against the 2GB repo limit.


Suggest an answer

Log in or Sign up to answer
AUG Leaders

Atlassian Community Events