Title: Graceful Error Pages Author: Bojan Josifoski Published: June 5, 2026 Last modified: June 5, 2026 --- Search plugins ![](https://ps.w.org/graceful-error-pages/assets/banner-772x250.png?rev=3562236) ![](https://ps.w.org/graceful-error-pages/assets/icon.svg?rev=3562236) # Graceful Error Pages By [Bojan Josifoski](https://profiles.wordpress.org/josifoskibojan/) [Download](https://downloads.wordpress.org/plugin/graceful-error-pages.1.0.7.zip) * [Details](https://wordpress.org/plugins/graceful-error-pages/#description) * [Reviews](https://wordpress.org/plugins/graceful-error-pages/#reviews) * [Installation](https://wordpress.org/plugins/graceful-error-pages/#installation) * [Development](https://wordpress.org/plugins/graceful-error-pages/#developers) [Support](https://wordpress.org/support/plugin/graceful-error-pages/) ## Description Every WordPress site shows the same plain white error screen when something goes wrong. It looks broken. It destroys trust. Graceful Error Pages replaces it with a page that matches your brand — automatically, the moment you activate it. **What it replaces:** * The `wp_die()` error screen (permission errors, expired links, security blocks) * PHP fatal error screens (white screen of death) **Features:** * **Zero-config activation** — works immediately with auto-detected site name, logo, and colors * **Five built-in templates** — Minimal, Corporate, Friendly, Dark, and Starter * **Brand customization** — logo, colors, heading, message, and redirect URL * **Merge tags** — dynamic content like {site_name} and {year} * **Self-contained styling** — no theme or CDN dependencies (works even during fatal errors) * **API safe** — only overrides HTML output; REST API, AJAX, and JSON responses are untouched * **WP-CLI safe** — automatically skips CLI contexts * **Lightweight** — zero overhead on normal page loads; only runs when an error occurs * **Fully translatable** — all strings use WordPress i18n functions **How it works:** 1. Activate the plugin 2. Your site’s error pages are instantly branded with auto-detected settings 3. Optionally customize via Settings > Error Pages **Source Code** The full source code, including unminified JavaScript and build tools, is available at: [github.com/codeverbojan/graceful-error-pages](https://github.com/codeverbojan/graceful-error-pages) To build from source: 1. Clone the repository 2. Run `composer install` 3. Run `npm install` 4. Run `npm run build` ## Screenshots * [[ * The default Minimal template replacing the WordPress error screen. * [[ * The settings page — Design tab with template picker. * [[ * The settings page — Content tab with messaging options. * [[ * The Corporate template with site logo. * [[ * The Dark template with dark mode styling. ## Installation 1. Upload the `graceful-error-pages` folder to `/wp-content/plugins/` 2. Activate the plugin through the ‘Plugins’ menu in WordPress 3. That’s it — error pages are now branded automatically 4. Optionally go to **Settings > Error Pages** to customize the template, colors, and messaging ## FAQ ### Does this work out of the box? Yes. On activation the plugin auto-detects your site name, logo, and brand color from your WordPress settings. Works with both classic and block (FSE) themes. No configuration is required. ### Which error screens does this replace? Two types: (1) the `wp_die()` screen shown for permission errors, expired nonces, and similar issues, and (2) the PHP fatal error screen (white screen of death). ### Will this break my REST API or AJAX? No. The plugin only overrides the HTML die handler. REST API, AJAX, JSON, and JSONP handlers are left completely untouched. ### Does this work with WP-CLI? Yes. The plugin detects CLI contexts and skips the custom handler entirely. ### Does this affect wp-admin? Not by default. The handler only fires on the front end unless you explicitly enable admin override in the settings. ### Can I create my own template? The five built-in templates cover most use cases. Custom template support is planned for a future release. ### Does this work with WooCommerce? Yes. The plugin works with any WordPress site, including WooCommerce stores. Error pages are styled independently of your theme or any other plugin. ### Does the plugin load anything on every page? No. The plugin registers its handler on init but only renders output when `wp_die()` is actually called or a fatal error occurs. There is zero performance impact on normal pages. ## Reviews There are no reviews for this plugin. ## Contributors & Developers “Graceful Error Pages” is open source software. The following people have contributed to this plugin. Contributors * [ Bojan Josifoski ](https://profiles.wordpress.org/josifoskibojan/) [Translate “Graceful Error Pages” into your language.](https://translate.wordpress.org/projects/wp-plugins/graceful-error-pages) ### Interested in development? [Browse the code](https://plugins.trac.wordpress.org/browser/graceful-error-pages/), check out the [SVN repository](https://plugins.svn.wordpress.org/graceful-error-pages/), or subscribe to the [development log](https://plugins.trac.wordpress.org/log/graceful-error-pages/) by [RSS](https://plugins.trac.wordpress.org/log/graceful-error-pages/?limit=100&mode=stop_on_copy&format=rss). ## Changelog #### 1.0.7 * Fix: Replace inline onclick handlers with wp_print_inline_script_tag #### 1.0.6 * Fix: Increase PHPStan memory limit to 1G for CI #### 1.0.5 * Fix: Remove dead sanitizer wrappers, add request method check #### 1.0.4 * Fix: Wp.org compliance — use wp_enqueue_style for all CSS output #### 1.0.3 * Fix author metadata and plugin URI across all files #### 1.0.2 * Add FSE/block theme brand color detection, fix PCP warnings #### 1.0.1 * Add @wordpress/scripts build process, rename prefix to gcep, upgrade PHPStan 2 #### 1.0.0 * Initial release * Custom wp_die() handler with branded error pages * PHP fatal error shutdown handler with self-contained styling * Five built-in templates: Minimal, Corporate, Friendly, Dark, Starter * Admin settings page under Settings > Error Pages * Auto-detection of site name, logo, and brand color on activation * Merge tags for dynamic content * Full i18n support ## Meta * Version **1.0.7** * Last updated **22 hours ago** * Active installations **Fewer than 10** * WordPress version ** 6.4 or higher ** * Tested up to **7.0** * PHP version ** 8.0 or higher ** * Tags * [branding](https://wordpress.org/plugins/tags/branding/)[error handling](https://wordpress.org/plugins/tags/error-handling/) [error page](https://wordpress.org/plugins/tags/error-page/) * [Advanced View](https://wordpress.org/plugins/graceful-error-pages/advanced/) ## Ratings No reviews have been submitted yet. [Your review](https://wordpress.org/support/plugin/graceful-error-pages/reviews/#new-post) [See all reviews](https://wordpress.org/support/plugin/graceful-error-pages/reviews/) ## Contributors * [ Bojan Josifoski ](https://profiles.wordpress.org/josifoskibojan/) ## Support Got something to say? Need help? [View support forum](https://wordpress.org/support/plugin/graceful-error-pages/)