404 Recovery Page Setup

The 404 Recovery Page is an optional replacement for your theme’s built-in 404 page. When enabled, it shows a branded, helpful error page with search, recent posts, and custom content options while keeping the HTTP 404 status. This gives visitors a better experience when they hit a missing URL without changing how search engines interpret the error.

Where to find it

Go to SEOvault AI > General > 404 Monitor and look for the “Recovery Page” section.

How it works

The recovery page replaces your theme’s 404 template only when:

The request is a 404 (no content found)
Fallback Behavior is set to Theme 404 (not homepage or custom URL redirects)
The recovery page is enabled in settings

The HTTP response stays 404, so search engines still understand the content is missing. The 404 Monitor still logs these requests like normal theme 404s.

Enable the recovery page

Go to SEOvault AI > General > 404 Monitor
In the “Recovery Page” section, check Enable Recovery Page
Click Save Changes

The recovery page now replaces your theme’s 404 for unmatched 404 requests.

Recovery page content options

Built-in content mode

The recovery page can show built-in content elements:

Headline — Custom headline text (default: “Page Not Found”)
Message — Custom message below the headline
Show Search — Display a WordPress search form
Show Home CTA — Display a button linking to your homepage or custom URL
CTA Label — Text for the home button (default: “Go Home”)
CTA URL — Custom target for the home button (defaults to homepage)
Show Recent Posts — Display a list of recent posts to help visitors find content
Recent Posts Count — How many recent posts to show (default: 5)

Page content mode

Instead of built-in elements, you can use the content from a WordPress page:

Create a WordPress page with your custom 404 content
In the recovery page settings, select Page Content mode
Choose the page from the dropdown
The recovery page will render your page’s content inside the recovery template

This lets you use the block editor, shortcodes, or any page content while still getting the recovery page’s styling and 404 status.

Styling options

Accent color

Choose an accent color for buttons, links, and highlights. The color is applied as a CSS variable that the recovery template uses.

Use theme colors

When enabled, the recovery page attempts to pull colors from your active theme (background, text, accent). If the theme doesn’t expose colors, it falls back to the accent color you specified.

When the recovery page appears

The recovery page only appears for frontend 404 requests. It does not appear for:

Admin area requests
AJAX requests
REST API requests
Cron jobs
Feed requests
Robots.txt requests

This ensures the recovery page only affects human visitors browsing your site.

HTTP status and logging

The recovery page keeps the HTTP 404 status. Search engines see a proper 404 response, which is correct for missing content. The 404 Monitor logs these requests like normal theme 404s, so you can still track which URLs are hitting the recovery page.

Customization

The recovery page uses a template file at views/not-found/recovery.php and a stylesheet at assets/css/not-found-recovery.css in the plugin directory. Advanced users can override these by:

Copying the template to your theme: your-theme/seovault-recovery.php
Using the seovaultseo_notfound_recovery_template filter to specify a custom template path
Using the seovaultseo_notfound_recovery_stylesheet filter to specify a custom stylesheet URL

Best practices

Use the recovery page when your theme’s 404 is generic or unhelpful
Enable search and recent posts to help visitors find relevant content
Consider page content mode if you want full control over the 404 presentation with the block editor
Keep the HTTP 404 status — don’t try to make missing URLs return 200
Monitor your 404 logs to identify high-traffic missing URLs that deserve specific redirects