What 503 means
The server can’t handle the request right now, usually because it’s overloaded or down for maintenance. It’s expected to be temporary. The server can say when to try again with Retry-After.
When servers send it
Planned maintenance, traffic spikes, a load balancer with no healthy servers left, or an app shedding load on purpose.
Common causes
- Maintenance mode switched on.
- More traffic than the servers can handle.
- All servers behind a load balancer failing their health checks.
- A dependency (database, cache) being down, so the app reports itself unavailable.
- Hosting limits reached on a small plan.
How to fix it as a developer
- Send
Retry-Afterduring maintenance, so clients and crawlers know when to come back. - Search engines treat a short 503 as temporary and keep the page indexed. A 200 maintenance page can get indexed instead.
- Check load balancer target health and the app’s readiness checks.
- For capacity problems, scale out, add caching, or shed load before the whole site slows.
How to fix it as a visitor
- Wait a few minutes and try again.
- Check the site’s status page or social media for maintenance news.
Related codes
- 502 Bad Gateway: A proxy or load balancer got an invalid response, or none at all, from the server behind it.
- 504 Gateway Timeout: A proxy or load balancer gave up waiting for the server behind it to reply.
- 429 Too Many Requests: You’ve sent too many requests in a given time. Slow down and try again later.
- 500 Internal Server Error: Something went wrong on the server, and it has no more specific code to describe it.
Where it’s defined
503 Service Unavailable is defined in RFC 9110, section 15.6.4. It’s a 5xx code, the server error class: the server, or something behind it, failed to deal with a valid request.
Other 5xx codes
500 Internal Server Error · 501 Not Implemented · 502 Bad Gateway · 504 Gateway Timeout · 505 HTTP Version Not Supported · 511 Network Authentication Required · 520 Web Server Returned an Unknown Error · 521 Web Server Is Down · 522 Connection Timed Out · 523 Origin Is Unreachable · 524 A Timeout Occurred · 525 SSL Handshake Failed · 526 Invalid SSL Certificate
Or search them all in the HTTP status code list.