WordPress - how to add a custom 500 server error page?

Question

It seems easy to create a custom error page in WordPress for a bad page, i.e., a 404 not found - just create 404.php in the theme directory.

I'd like to do the same for a server error, say if a CGI script on my WordPress site does something stupid like divide by 0.

I tried creating a 500.php page in my theme directory but it appears to be ignored. Instead, the 404.php page in the theme directory is called.

It seems that WordPress somehow catches the server error and translates it into a "not found" error and then uses 404.php

How can I make WordPress go to a different custom page in case of a server error (500), as opposed to a simple page not found (404) error?

And before you tell me to put something like ErrorDocument 500 /path-to-custom-error-page in a .htaccess file, already tried that - it gets ignored by the web server, probably because the RewriteRule directives in the same file are used by WordPress to intercept and handle all requests (and no it doesn't matter if the ErrorDocument directive is above or below the WordPress RewriteRule section).

(Note: I tried researching this on my own, but search results are polluted by people complaining about getting server errors with WordPress, not asking how to create a custom page to handle them.)

Natalia · Accepted Answer · 2015-03-25 17:18:17Z

6

Since WP 3.0 you can override the standard error pages that wp_die() uses, with the wp_die_handler filter.

'wp_die' and 'wp_die_handler' are located in wp-includes/functions.php.

answered Mar 25, 2015 at 17:18

Natalia

811 silver badge2 bronze badges

Sign up to request clarification or add additional context in comments.

1 Comment

Natalia Over a year ago

Here's a Gist for anyone who needs something as a 'guide'. :)

webaware · Accepted Answer · 2012-12-01 09:57:03Z

5

WordPress will never be able to show your custom error page for a server error (500). You need to create a .html or PHP page, outside of WordPress. Your host may already have something to help you there, many have a folder into which you can put custom error pages, outside the website's root folder.

answered Dec 1, 2012 at 9:57

webaware

2,8193 gold badges34 silver badges39 bronze badges

1 Comment

Solomon Closson Over a year ago

How to do this on localhost??

sam · Accepted Answer · 2014-06-14 20:37:05Z

0

ErrorDocument 500 … should work in any case if the path is correct. Turn off WordPress's rewrite rules, produce a 500 error, and Apache should either show /path-to-custom-error-page or say it can't find it.

answered Jun 14, 2014 at 20:37

sam

40.7k2 gold badges43 silver badges38 bronze badges

2 Comments

reallynice Over a year ago

It seems to me that this addresses only static 500 pages. Personally I prefer declaring both static (if there's a problem between apache and the techology you are using) and dynamic ones (if the communication between apache and the underlying technology is fine, and while processing that request you encounter an error and want to show information related to that request's context).

Solomon Closson Over a year ago

How to turn off Wordpress rewrite rules? disable permalinks altogether?

Collectives™ on Stack Overflow

WordPress - how to add a custom 500 server error page?

3 Answers 3

1 Comment

1 Comment

2 Comments

Your Answer

Hot Network Questions

Collectives™ on Stack Overflow

3 Answers 3

1 Comment

1 Comment

2 Comments

Your Answer

Sign up or log in

Post as a guest

Related