Skip to content
Go to file

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time

HttpStatus JSP Tag Library

release Maven Central Download
License (3-Clause BSD) Known Vulnerabilities Quality Gate Status
Build Status Build status CircleCI

A simple JSP Tag Library to display the code, reason and/or cause for HTTP status codes in JSP error pages.

For example:

<%@ page isErrorPage="true" %>
<%@ taglib prefix="hs" uri="" %>
<title><hs:code/> <hs:reason default="Server Error"/></title>
<h1><hs:reason default="Server Error"/></h1>
Cause: <pre><hs:cause default="Unable to complete your request."/></pre>


<%@ page isErrorPage="true" import="net.thauvin.erik.httpstatus.Reasons" %>
<%= Reasons.getReasonPhrase(pageContext.getErrorData().getStatusCode()) %>

would display on a 501 status code:

Not Implemented


The <hs:cause/> tag displays the cause of current HTTP status code, if any. A shorthand for:

<%= pageContext.getErrorData().getThrowable().getCause().getLocalizedMessage() %>

Optional attributes are:

Attribute Description
default The fallback value to output, if no cause is available.
escapeXml Converts <, >, &, ', " to their corresponding entity codes. Value is true by default.


The <hs:code/> tag displays the current HTTP status code, if any. A shorthand for:

<%= pageContext.getErrorData().getStatusCode() %>


The <hs:reason/> tag displays the reason for a HTTP status code, if any. Optional attributes are:

Attribute Description
code The HTTP status error code. If not specified the current status code is used.
default The fallback value to output, if no reason is available.
escapeXml Converts <, >, &, ', " to their corresponding entity codes. Value is true by default.

The reasons are defined in a ResourceBundle properties as follows:

Status Code Reason
100 Continue
101 Switching Protocols
102 Processing
103 Early Hints
200 OK
201 Created
202 Accepted
203 Non-Authoritative Information
204 No Content
205 Reset Content
206 Partial Content
207 Multi-Status
208 Already Reported
218 This is fine
226 IM Used
300 Multiple Choices
301 Moved Permanently
302 Found/Moved Temporarily
303 See Other
304 Not Modified
305 Use Proxy
306 Switch Proxy
307 Temporary Redirect
308 Permanent Redirect
400 Bad Request
401 Unauthorized
402 Payment Required
403 Forbidden
404 Not Found
405 Method Not Allowed
406 Not Acceptable
407 Proxy Authentication Required
408 Request Timeout
409 Conflict
410 Gone
411 Length Required
412 Precondition Failed
413 Request Entity/Payload Too Large
414 Request-URI Too Long
415 Unsupported Media Type
416 Requested Range Not Satisfiable
417 Expectation Failed
418 I'm A Teapot
419 Insufficient Space on Resource
420 Method Failure
421 Misdirected Request
422 Unprocessable Entity
423 Locked
424 Failed Dependency
426 Upgrade Required
428 Precondition Required
429 Too Many Requests
430 Request Header Fields Too Large
431 Request Header Fields Too Large
440 Login Timeout
444 No Response
449 Retry With
450 Blocked by Windows Parental Controls
451 Unavailable For Legal Reasons
460 Client Closed Connection Before Load Balancer Idle Timeout
463 X-Forwarded-For Header with More than 30 IP Addresses
494 Request Header Too Large
495 SSL Certificate Error
496 No SSL Certificate
497 HTTP Request Sent to HTTPS Port
498 Token Expired/Invalid
499 Client Closed Request
500 Internal Server Error
501 Not Implemented
502 Bad Gateway
503 Service Unavailable
504 Gateway Timeout
505 HTTP Version Not Supported
506 Variant Also Negotiates
507 Insufficient Storage
508 Loop Detected
509 Bandwidth Limit Exceeded
510 Not Extended
511 Network Authentication Required
520 Unknown Error
521 Web Server Is Down
522 Origin Connection Time-out
523 Origin Is Unreachable
524 A Timeout Occurred
525 SSL Handshake Failed
526 Invalid SSL Certificate
527 Railgun Error
529 Site is overloaded
530 Site is frozen
598 Network Read Timeout Error
599 Network Connect Timeout Error

Usage with Gradle or Maven

Include the following in your build.gradle file:

dependencies {
    implementation 'net.thauvin.erik.httpstatus:httpstatus:1.0.5'

or as a Maven artifact:


Command Line Usage

You can query the reason phrase for status codes as follows:

$ java -jar httpstatus-1.0.5.jar 404 500
404: Not Found
500: Internal Server Error

If no status code is specified, all will be printed:

$ java -jar httpstatus-1.0.5.jar
100: Continue
101: Switching Protocols
102: Processing
103: Early Hints
200: OK
201: Created
202: Accepted
203: Non-Authoritative Information
204: No Content
205: Reset Content
206: Partial Content
207: Multi-Status
208: Already Reported
226: IM Used
You can’t perform that action at this time.