TooManyDistributions
AWS TooManyDistributions means processing the CloudFront request would exceed the account limit for distributions (HTTP 400).
Last reviewed: March 5, 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 Too Many Distributions Mean?
CloudFront blocked distribution creation because account distribution quota headroom is exhausted, so rollout stops until count is reduced or quota is raised.
Common Causes
- -Account reached the CloudFront distribution count limit.
- -Provisioning creates one-off distributions without decommission lifecycle cleanup.
- -Environment sprawl multiplies distribution count faster than quota planning.
- -Quota increase request was not completed before rollout demand.
How to Fix Too Many Distributions
- 1Inventory and remove obsolete or unused distributions where safe.
- 2Consolidate low-traffic environments under shared distribution patterns when possible.
- 3Request account quota increase for planned distribution growth.
- 4Retry create only after quota headroom is confirmed.
Step-by-Step Diagnosis for Too Many Distributions
- 1Capture failing request ID and count current active distributions in account.
- 2Correlate distribution growth timeline with onboarding and environment creation workflows.
- 3Check pending deletions that are not fully retired yet from quota perspective.
- 4Validate quota values and recent increase-request history.
Distribution Quota Utilization Analysis
- -Measure active and pending-deletion distribution counts against quota (example: many disabled-but-not-fully-deleted distributions still consume quota).
- -Correlate distribution growth with environment lifecycle practices (example: preview distributions never retired after PR close).
Provisioning Gate and Cleanup Controls
- -Add pre-create quota gate in CI/CD (example: block CreateDistribution when projected count exceeds 90% headroom threshold).
- -Automate distribution retirement pipelines (example: nightly job purges expired sandbox distributions after TTL).
Seen in Production
Preview environments create per-branch distributions and never clean up
Frequency: common
Example: CI pipeline eventually hits account distribution limit and blocks new deployments.
Fix: Implement automatic distribution teardown policy for expired preview environments.
Regional expansion doubles distribution footprint unexpectedly
Frequency: rare
Example: Rollout strategy duplicates distributions by region without quota impact planning.
Fix: Forecast distribution growth and secure quota increase before expansion milestones.
Debugging Tools
- -Service Quotas console
- -CloudFront distribution inventory reports
- -CloudTrail distribution lifecycle history
- -Provisioning pipeline quota gates
How to Verify the Fix
- -Confirm CreateDistribution succeeds after cleanup or quota increase.
- -Validate remaining headroom is sufficient for near-term rollout plans.
- -Ensure provisioning jobs no longer fail on distribution-limit checks.
How to Prevent Recurrence
- -Track distribution count growth and alert before approaching quota thresholds.
- -Automate retirement lifecycle for deprecated environments/distributions.
- -Include quota gate checks in CI/CD before creating new distributions.
Pro Tip
- -reserve distribution quota budget per environment class (prod/stage/preview) so temporary environments cannot starve production rollouts.
Official References
Provider Context
This guidance is specific to AWS services. Always validate implementation details against official provider documentation before deploying to production.