Troubleshoot content delivery
Make Delivery API and GraphQL calls reliable. Handle timeouts and rate limits, fix empty references and unexpected locales, and know the limits before you hit them.
- Step 1: GuideLevel: Intermediate
ETIMEDOUT, 5xx and timeouts from the Delivery API
Fix ETIMEDOUT, status 0, 502, 503 and 504 errors from the Content Delivery API with SDK retries, timeouts, keep-alive, IPv4 and a last-good-data fallback.
Checkpoint: Your fetch layer has timeouts, retries and keep-alive.
- Step 2: GuideLevel: Intermediate
Fix 429 rate limit errors in builds, imports and bulk publish
Find where 429 Too Many Requests errors come from in static builds, csdx imports, bulk publish and scripts, then fix them with backoff, pacing and fewer calls.
Checkpoint: Builds and imports back off instead of failing on 429.
- Step 3: GuideLevel: Intermediate
Nested references come back empty, or fail with error 141
Why referenced entries come back as bare UIDs, empty arrays or a 422 with error_code 141 from the Content Delivery API, and how to fix each cause.
Checkpoint: Deep references resolve or are modeled around the depth limit.
- Step 4: GuideLevel: Intermediate
Why am I getting en-us content? Locale fallback explained
You request de-de and get English. How fallback languages, unlocalized entries, include_fallback and GraphQL fallback_locale decide which locale you get back.
Checkpoint: Locale fallback behaves the way you configured it.
- Step 5: GuideLevel: Intermediate
GraphQL errors decoded: depth, cost and partial data
What MAX_REFERENCE_DEPTH_LIMIT_EXCEEDED, MAX_RESOLVER_COST_EXCEEDED and other Contentstack GraphQL errors mean, why HTTP 200 can fail, and how to fix each.
Checkpoint: You can read and fix GraphQL limit and partial-data errors.
- Step 6: GuideLevel: Beginner
Contentstack limits on one page
Every public Contentstack limit in one place, from API rate limits and reference depth to fields, taxonomy, assets, webhooks, Launch and the CLI.
Checkpoint: You know the limits that apply to your plan and code.
Path complete
Browse all learning paths