How to create a custom 404 page in WordPress

What the WordPress 404 page is

A 404 page is what a visitor sees after following a broken, mistyped, or out-of-date link. WordPress has a built-in one, but most themes ship a cold, generic version — a bare "Oops! That page can't be found" with a search box. That page quietly loses visitors who would have stayed if they had a clear way back.

How you customise it depends on which kind of theme you run. Classic themes (the long-standing model — Astra, GeneratePress, most older themes) use PHP template files. Block themes (Twenty Twenty-Four, Twenty Twenty-Five and other full-site-editing themes) are edited visually in the Site Editor. Check under Appearance › Themes — if you see an Editor item under Appearance, you have a block theme.

Method 1 — Add a 404.php template (classic themes)

WordPress's template hierarchy looks for a file named 404.php in your active theme and uses it for every missing page automatically. You never have to wire it up — you just have to create it in the right place.

/*
 Theme Name:   Your Theme Child
 Template:     yourtheme
*/

<?php
add_action( 'wp_enqueue_scripts', function () {
    wp_enqueue_style( 'parent-style', get_template_directory_uri() . '/style.css' );
} );

<?php
/**
 * 404 — Page Not Found template
 */
get_header(); ?>

<main class="error-404">
  <h1>We can't find that page</h1>
  <p>The link may be broken, or the page may have moved.</p>

  <?php get_search_form(); ?>

  <p>
    <a href="<?php echo esc_url( home_url( '/' ) ); ?>">
      Back to the homepage
    </a>
  </p>

  <h2>Popular pages</h2>
  <?php wp_nav_menu( array( 'theme_location' => 'primary' ) ); ?>
</main>

<?php get_footer(); ?>

Method 2 — Edit the 404 template in the Site Editor (block themes)

If you run a block theme, there is no PHP to touch. The 404 page is a template you edit visually.

Method 3 — Use a plugin (no code)

If you would rather design your 404 page as an ordinary WordPress Page — with your page builder, your blocks, your layout — use a plugin that maps a Page to the 404 response.

• Install 404page – Your Smart Custom 404 Error Page from Plugins › Add New.
• Create a normal Page with the content and design you want.
• Under Appearance › 404 Error Page, select that Page as your 404.

The plugin intercepts missing URLs and serves your chosen Page with a proper 404 status header — which a plain published Page on its own would not do. SEO-focused builders such as SeedProd and Elementor Pro offer similar 404-template features.

Make sure your 404 page returns a real 404 status

A correct 404 page must return the HTTP status code 404. WordPress's 404.php template and the block 404 template both do this automatically. The status only goes wrong when something else intercepts the request first — a redirect plugin, a caching rule, or a "redirect all unknown URLs to home" setting.

To check: visit a URL you know does not exist, like yoursite.com/this-page-is-not-real. It should show your new 404 design. Then confirm the status code — open your browser's developer tools, go to the Network tab, reload, and look at the status of the first request. It must say 404. If it says 200, you have a soft 404 — see our guide to fixing soft 404 errors.

What makes a WordPress 404 page actually good

Getting the template in place is the easy part. A 404 page earns its keep only if it does the job: turning a dead end into a recovery. The best ones share a clear anatomy — they orient the visitor ("this page is missing, here's why"), offer real escape routes to popular content, include working site search, suggest pages the visitor probably meant, and carry the brand's voice instead of an apologetic shrug.

We break down all twelve traits the strongest 404 pages share on the main page. The short version: a 404 page is a design and copywriting surface, not an error message — so write and build it like one.

Frequently asked questions

Related guides