BACK TO DIRECTORY






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:
- Activate the plugin
- Your site’s error pages are instantly branded with auto-detected settings
- 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
To build from source:
- Clone the repository
- Run
composer install - Run
npm install - 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.
Plugin Details
Active Installs
0Total Downloads
190Version
1.0.7Requires WP
6.4Requires PHP
8.0Tested Up To
7.0.4Added
2026-06-05Last Updated
2026-06-05 10:38am GMTRatings
5
0
4
0
3
0
2
0
1
0