All Tools View Categories About Contact Privacy

Status Code Reference

Decode HTTP and Nginx-specific status codes with causes.

Runs entirely in your browser - nothing is uploaded and no cloud connection is made.
Status code information will appear here.
-
results

About Status Code Reference

When nginx returns a status code, the number alone rarely tells the whole story - especially the Nginx-specific 49x and 499 codes that never appear in generic HTTP references. The Status Code Reference explains both common HTTP codes and the Nginx-specific ones, with the typical cause and the directive or setting that usually resolves it. Search by code or name and get a focused report, all computed locally in your browser with nothing uploaded.

At the heart of the configuration are a handful of directives. Success codes codes such as 200, 201 and 204 indicate the request was fulfilled or a resource was created. Redirect codes codes such as 301, 302, 307 and 308 move clients to another URL with varying permanence. Client error codes codes such as 400, 401, 403, 404 and 405 signal a problem with the request or permissions. Rate and size codes codes such as 413 and 429 arise from body size limits and request rate limiting. Server error codes codes such as 500, 502, 503 and 504 indicate backend, gateway or overload failures. Nginx 49x codes codes such as 494, 495, 496 and 497 are emitted by nginx for header and TLS edge cases. Nginx 499 code 499 means the client closed the connection before nginx completed the response. error_page mapping the error_page directive maps any status code to a custom response URI. Together they shape how the server behaves, and the tool assembles them in the right context so the result is valid on the first try.

Common mistakes are easy to make. Confusing 502 with 504: 502 is a bad upstream response, 504 is an upstream timeout. Assuming 499 is a server bug when it usually reflects a slow backend or impatient client. Using 301 for temporary maintenance will cache the redirect in browsers and CDNs. Forgetting that custom error pages still return the original status unless you change it. The generator anticipates each of these and either sets a safe default or rejects the input with a clear message before anything is written to your clipboard.

Validation is strict because small configuration errors fail in subtle ways. Every input is checked for plausibility, and after the block is assembled it is re-parsed by a built-in tokenizer so unbalanced braces, missing semicolons or stray characters cannot reach your clipboard. Stat cards report line and block counts, and copy, download and print exports are one click away. Everything runs in your browser; nothing you type is transmitted to any server.

In practice this block drops into any standard nginx install. Save the output as a file under /etc/nginx/conf.d/ (or sites-available with a symlink), run nginx -t to confirm the syntax, then reload with nginx -s reload. Because the generator emits a single, self-contained server block with no hidden dependencies, it composes cleanly with your existing caching, logging and security configuration without directive collisions.

Beyond producing correct config, the tool is a reference you can read back and learn from. Each control maps to a real nginx directive, the sample button shows a complete working block in seconds, and clearing the form resets every field to its safe default. Standardising on a generator like this removes per-developer variation, keeps your configuration readable, and gives you a repeatable, auditable setup that passes nginx -t on the first try.

When something looks wrong in production, the first move is always to re-run nginx -t and inspect /var/log/nginx/error.log; most failures surface there with a line number. The access log records every request, so a sudden spike or a wall of 499 responses points straight at backend or timeout problems the generator helps you avoid in the first place.

This server block is designed to sit alongside - not fight - your other configuration. Because it declares its own server_name and a single, self-contained set of directives, you can drop it into conf.d without worrying about collisions with global caching, logging or security snippets that live elsewhere in the nginx tree.

For a production site, pair this block with TLS termination: serve on 80 for the redirect or health checks, and place the encrypted listener (or a front-end load balancer / CDN) in front so clients always speak HTTPS. The generator keeps that boundary clean so the two layers compose instead of overlapping.

If a change ever needs to be undone, the output is plain text you control: delete the file from conf.d, re-run nginx -t, and reload. There is no database and no hidden state, so rolling back is as simple as restoring the previous version from version control or your own backup.

Features

  • Success codes - codes such as 200, 201 and 204 indicate the request was fulfilled or a resource was created.
  • Redirect codes - codes such as 301, 302, 307 and 308 move clients to another URL with varying permanence.
  • Client error codes - codes such as 400, 401, 403, 404 and 405 signal a problem with the request or permissions.
  • Rate and size codes - codes such as 413 and 429 arise from body size limits and request rate limiting.
  • Server error codes - codes such as 500, 502, 503 and 504 indicate backend, gateway or overload failures.
  • Nginx 49x codes - codes such as 494, 495, 496 and 497 are emitted by nginx for header and TLS edge cases.
  • Nginx 499 code - 499 means the client closed the connection before nginx completed the response.
  • error_page mapping - the error_page directive maps any status code to a custom response URI.
  • Self-verifying output re-parsed before display.
  • Copy, Download and Print exports.
  • Load-sample button fills realistic values.
  • Statistics cards for quick checks.
  • Runs entirely in your browser - nothing uploaded.

How to Use

  1. Type a status code or name into the search box (e.g. 404 or Not Found).
  2. Click Look up (or Load sample to prefill 404).
  3. Read the description, cause and related directive in the report.
  4. If several codes match, a candidate list with summaries is shown.
  5. Click Download to save the text report or Download JSON for structured data.
  6. Use the related directive to fix or customise the behaviour.
  7. Clear the box to look up another code.

Examples

Example 1 - Look up 404 typing 404 returns 404 Not Found with its cause and an error_page example.

Example 2 - Look up 502 typing 502 explains the bad gateway cause and points at proxy settings.

Example 3 - Partial match typing 50 lists 500, 502, 503 and 504 together.

Example 4 - Empty query submitting an empty box returns a clear error asking for a code.

Example 5 - Unknown code typing a made-up code returns an error indicating no code was found.

Benefits

  • Explains both standard and Nginx-specific status codes.
  • Each entry lists the usual cause and the directive to fix it.
  • Search by code or by human-readable name.
  • Partial matching helps when you only recall digits.
  • One-click JSON and text export for runbooks.
  • Private: the glossary is embedded, nothing uploaded.

Frequently Asked Questions

What is a status code?
An HTTP status code is a three-digit number nginx returns to indicate the result of a request, such as 200 for success or 404 for missing.
What are Nginx-specific codes?
Codes in the 49x and 499 range are produced by nginx itself, for example 499 when the client closes the connection early.
Why did I get 502?
A 502 Bad Gateway means nginx received an invalid response from the upstream server you proxy to, often a crashed or slow backend.
What does 499 mean?
499 Client Closed Request means the client disconnected before nginx finished responding, frequently a symptom of slow upstreams.
When should I use 301 versus 302?
Use 301 for permanent moves that clients and caches should remember, and 302 or 307 for temporary redirects.
How do I customise an error page?
Use the error_page directive to map a status code to a local URI that serves your custom page.
Is the data uploaded?
No. The status code glossary is built into the page and lookups run locally in your browser.
Can I export the result?
Yes. Download JSON for structured data or Download for the plain-text report.