Skip to content

Source-backed platform rule

GitHub browser file upload size limit: 25 MiB per file

A file can fit a Git push and still be too large for GitHub's web uploader. This reference isolates the browser ceiling and records how GitHub's documentation variable supplies the numeric value.

RuleRoster is independent and is not affiliated with or endorsed by GitHub.

Direct answer

What is the rule?

GitHub.com repository uploads through a browser are limited to 25 MiB per file. This is a browser-upload limit, not the separate Git push or LFS limit.

Scope
GitHub.com repository browser uploads; MiB per file
Rule verified
October 14, 2026
Source checked
October 19, 2026

Published evidence

Rule details

Browser file size ceiling

The browser upload ceiling is 25 MiB for each file. A limit on file size is not an authorization to upload its contents.

Upload channel and units

This record covers repository uploads through the GitHub.com browser interface. Git pushes, Git LFS and release assets have separate limits. Keep MiB distinct from decimal MB.

How the numeric value is sourced

The official article references large_files.max_github_browser_size. Its numeric value is bound to the GitHub Docs variables file at the same immutable commit; both documents are required.

Evidence trail

Official sources

Attribution and license

Adapted from GitHub Docs by GitHub and contributors under Creative Commons Attribution 4.0 International: https://creativecommons.org/licenses/by/4.0/. Source: https://github.com/github/docs/tree/d67ced7268844cdf7d856f4eb0b9b2018406da29. RuleRoster extracted and paraphrased the scoped limit and bound the article to its variables. No affiliation or endorsement is implied.

Interpretation and accountability

Before you act

  1. Confirm that the scope matches your case.
  2. Keep recommendations, enforced limits, exceptions, and unstated details distinct.
  3. Open the official source before relying on the rule for a consequential decision.

Record dates

Published
October 14, 2026
Rule verified
October 14, 2026
Source checked
October 19, 2026
Review due
November 2, 2026

Challenge this record

If the source or summary appears wrong, submit precise evidence for human review.

Submit a correction