Conditions for large files

GitHub limits the size of files allowed in repositories, and will block a push to a repository if the files are larger than the maximum file limit.

Tip: If you regularly push large files to GitHub, consider using Git Large File Storage (Git LFS). For more information, see "Versioning large files."

Warning for files larger than 50 MB

If you attempt to add or update a file that is larger than 50 MB, you will receive a warning from Git. The changes will still successfully push to your repository, but you can consider removing the commit to minimize performance impact. For more information, see "Removing files from a repository's history."

Blocked pushes for large files

GitHub blocks pushes that exceed 100 MB.

Did this doc help you?Privacy policy

Help us make these docs great!

All GitHub docs are open source. See something that's wrong or unclear? Submit a pull request.

Make a contribution

Or, learn how to contribute.