Quick answer
Gemini documents file upload as 10 files per prompt; 100 MB each, or 2 GB per video. Folders and repositories count their contained files and have separate caps.
Verified Aug 22, 2026Official source
Current limits
| Constraint | Current value | Scope | Verified source |
|---|---|---|---|
| file uploadFolders and repositories count their contained files and have separate caps. | 10 files per prompt; 100 MB each, or 2 GB per video | Supported Gemini Apps accounts | GoogleAug 22, 2026 |
Why does this limit matter?
Video byte limits, media-duration limits, prompt file counts, and context capacity can each be the first blocker.
This value is scoped to Supported Gemini Apps accounts; a different plan, runtime, model, endpoint, region, or account can produce a different effective constraint.
What should you check?
- Count files, bytes, media duration, and estimated tokens before uploading.
- Confirm the exact plan, model, runtime, endpoint, region, and account that serve the failing workload.
- Record the observed value, response headers or configuration, timestamp, and source without logging secrets.
Important caveats
- The 10-file allowance is subject to availability, and rolling file-analysis limits also apply.
- Treat the official source and live account configuration as authoritative if they differ from this verified snapshot.
HyperObserve reports the documented platform constraint. Your application, SDK, gateway, provider, region, or account can impose a lower effective limit.
Related