EntityTooLarge
AWS EntityTooLarge (Entity Too Large) means the proposed upload exceeds the maximum allowed object size. In Amazon S3, this error returns HTTP 400.
Last reviewed: March 29, 2026|Source-backed guidance under our editorial policy
Start Here
Use the closest compare guide, playbook, or adjacent error page to narrow the decision faster before you start changing production systems.
This page is part of the Error Reference library. Learn more about the project or report a correction.
What Does Entity Too Large Mean?
S3 rejected the payload size for the selected upload path, so the object is not stored until upload mode and size boundaries are corrected.
Common Causes
- -Payload exceeds the S3 size quota for the chosen upload operation.
- -Large object is sent via single-request upload instead of multipart.
- -Uploader thresholds are stale for the current bucket type, endpoint, or operation path.
How to Fix Entity Too Large
- 1Route oversized uploads to multipart flow when one-shot upload limits are exceeded.
- 2Validate object and part-size constraints against current S3 quotas for the exact operation and endpoint.
- 3Retry with corrected upload mode, thresholds, and chunk boundaries.
Step-by-Step Diagnosis for Entity Too Large
- 1Record object size and selected upload mode for each failure.
- 2Inspect uploader branch selection, chunking logic, and part sizes in traces.
- 3Reproduce in a controlled environment with deterministic file size tests.
Upload Mode and Size Boundary Checks
- -Validate payload size against the exact operation boundary (example: single-request upload path selected after object size crosses that path limit).
- -Confirm multipart path is used for large payloads with valid part sizing (example: uploader forced to single-shot mode after feature-flag drift).
Chunking and Transfer Pipeline Validation
- -Inspect chunker logic and part-size configuration (example: transformed payload exceeds planned size after compression disabled).
- -Audit upload client branch selection by size threshold (example: 6 GiB file incorrectly routed to non-multipart path).
Seen in Production
Client sends multi-gigabyte file through single PutObject path
Frequency: common
Example: Upload service bypasses multipart threshold and S3 rejects oversize request body.
Fix: Route large files to multipart upload flow with validated part sizes.
Compression disabled during rollout and payload size unexpectedly exceeds thresholds
Frequency: rare
Example: A deployment change increases effective upload size and triggers sudden EntityTooLarge errors.
Fix: Enforce pre-upload size checks and feature-flag guardrails for payload transformations.
Debugging Tools
- -Uploader part-size telemetry
- -AWS CLI --debug
- -Multipart integration tests
- -S3 upload request traces
How to Verify the Fix
- -Re-run upload and confirm EntityTooLarge no longer appears.
- -Validate object size and multipart boundaries on the completed upload.
- -Confirm size-related upload failures stay below baseline.
How to Prevent Recurrence
- -Route uploads by size threshold to PutObject or multipart appropriately.
- -Add boundary tests for max object and part sizes in upload clients.
- -Monitor upload-size distribution and failures by operation mode.
Pro Tip
- -compute and log effective payload size after all client-side transforms so upload-path routing decisions use true wire-size, not source file size.
Official References
Provider Context
This guidance is specific to AWS services. Always validate implementation details against official provider documentation before deploying to production.