WP_Fatal_Error_Handler::display_error_template( array $error, true|WP_Error $handled )

In this article

Displays the PHP error template and sends the HTTP status code, typically 500.


A drop-in ‘php-error.php’ can be used as a custom template. This drop-in should control the HTTP status code and print the HTML markup indicating that a PHP error occurred. Note that this drop-in may potentially be executed very early in the WordPress bootstrap process, so any core functions used that are not part of wp-includes/load.php should be checked for before being called.

If no such drop-in is available, this will call WP_Fatal_Error_Handler::display_default_error_template().


Error information retrieved from error_get_last().
Whether Recovery Mode handled the fatal error.


protected function display_error_template( $error, $handled ) {
	if ( defined( 'WP_CONTENT_DIR' ) ) {
		// Load custom PHP error template, if present.
		$php_error_pluggable = WP_CONTENT_DIR . '/php-error.php';
		if ( is_readable( $php_error_pluggable ) ) {
			require_once $php_error_pluggable;


	// Otherwise, display the default error template.
	$this->display_default_error_template( $error, $handled );


5.3.0The $handled parameter was added.

User Contributed Notes

You must log in before being able to contribute a note or feedback.