👋 We've unified all of GitHub's product documentation in one place! Check out the content for REST API, GraphQL API, and Developers. Learn more on the GitHub blog.
Article version: GitHub.com

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.

In this article

Were you able to find what you were looking for?

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.

Were you able to find what you were looking for?

Ask a human

Can't find what you're looking for?

Contact us