Graceful Error Pages
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
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:
- 01Activate the plugin
- 02Your site’s error pages are instantly branded with auto-detected settings
- 03Optionally 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:
- 04Clone the repository
- 05Run composer install
- 06