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

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().



(array) (Required) Error information retrieved from error_get_last().


(true|WP_Error) (Required) Whether Recovery Mode handled the fatal error.


File: wp-includes/class-wp-fatal-error-handler.php

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 );


Version Description
5.3.0 The $handled parameter was added.
5.2.0 Introduced.

© 2003–2019 WordPress Foundation
Licensed under the GNU GPLv2+ License.