Conditions for large files
GitHub will warn you when pushing files larger than 50 MB. You will not be allowed to push files larger than 100 MB.
Tip: If you regularly push large files to GitHub, consider introducing Git Large File Storage (Git LFS) as part of your workflow. Git LFS works well with the GitHub Flow and can be used with any large file, regardless of its type. For more information, see "Versioning large files."
50 MB push warning
When pushing to GitHub, you'll receive a warning or error message if you either add a new file or update an existing file that is larger than 50 MB.
The warning will tell you which files are too large:
> remote: warning: Large files detected. > remote: warning: File big_file is 55.00 MB; this is larger than GitHub's recommended maximum file size of 50 MB
The push with
big_file is received and saved into the repository on GitHub, but you should consider removing the file and the commit entirely.
100 MB push limit
If you push a file larger than 100 MB to GitHub, Git will reject the push and tell you which file is too large:
> remote: warning: Large files detected. > remote: error: File giant_file is 123.00 MB; this exceeds GitHub's file size limit of 100 MB
This push was rejected because of
giant_file. The commits will not be saved into the repository on GitHub.