Fastly · HTTP 503

Fastly 503: Shield POP Unavailable

Troubleshoot Fastly shield failures by checking shield selection, backend health, request routing, and the connection from shield POP to origin.

CDN / Edge Network

Decode a CDN or gateway error

Paste a captured HTTP response or enter a status and headers. Only the status and response headers are sent; common credential headers are filtered first.

Supports raw headers, full HTTP responses, JSON with status/statusCode and headers, cURL -v/-i response output, and HAR exports. HAR selects a server error first. cURL commands are never executed; request headers, response bodies, and common credential headers are excluded.

Diagnostic report

Error code / name

FASTLY-SHIELD_UNAVAILABLE

Fault domain

CDN / Edge Network

Why it happened

The edge could not obtain a response through its configured shield path. A shield POP can be reachable while its backend route, DNS, or origin connection is failing.

Actionable fixes

  1. Compare x-served-by and cache headers to determine whether the request reached the expected shield.
  2. Check shield assignment, backend health, and origin reachability from the shield region.
  3. Test direct backend and shielded paths separately before changing shielding or failover configuration.

Why this error happened

The edge could not obtain a response through its configured shield path. A shield POP can be reachable while its backend route, DNS, or origin connection is failing.

Actionable fixes

  1. Compare x-served-by and cache headers to determine whether the request reached the expected shield.
  2. Check shield assignment, backend health, and origin reachability from the shield region.
  3. Test direct backend and shielded paths separately before changing shielding or failover configuration.

Network failure point

Client -> Fastly Edge -> Shield POP -> backend fetch fails -> X

Verify origin directly via CLI

curl -sS -I -v --connect-timeout 5 --max-time 20 https://www.example.com/health

Configuration fix

main.vclvcl
backend origin {
  .host = "origin.example.com";
  .port = "443";
  .use_ssl = true;
  .shield = "iad-va-us";
}

Catch this failure before it becomes an outage

SteadyNode checks the customer-facing endpoint from multiple regions and records edge headers, helping expose location-specific shield or backend failures.

No credit card required.

Start for free

Frequently asked questions

Does a shield error mean the edge POP is down?

Not necessarily. The edge may be healthy while the shield-to-origin fetch or configured shield route is failing.

Should I remove shielding to restore service?

First compare direct and shielded backend paths. Removing shielding can change origin load and cache behavior, so validate the impact before changing it.

Cloudflare

Vercel and Netlify

AWS CloudFront and ALB

Fastly

Heroku and Render

Nginx and Envoy