How to Create a Custom Error 404 page for WordPress


This tutorial will teach you how to create an error 404 page for your WordPress powered site. If you already have an error 404 page you will learn how to make it a bit more user-friendly and dynamic.

An error 404 is when a visitor tries to access a page that does not exist. Sometimes people tend to overlook this feature, and never think about designing for it. Taking the time to make a user-friendly 404 page could mean the difference in a user staying on your website, or leaving.

Taking a look at it

Most chances are you have created your website and checked multiple times to be sure that every link leads to somewhere. Eventually over time you may forget about a link that leads to a post you removed, or possibly changed the name to. Even if a visitor is searching for a page directly and they don’t get it right, then they will be taken to the error 404 page.

These can be made very user-friendly utilizing the WordPress template tags, and little bit of know-how.

Understanding The error 404

The error 404 is a message that the visitor will receive when a page or post is not located. This is by default included within WordPress, but not with all themes. If you have created a custom theme, then you can increase the chances of a user sticking around even though they didn’t find what they were looking for with a properly designed 404 page.

The basic error 404 template

The basic error 404 template is included with some WordPress themes but not all. WordPress is set to automatically look for the file 404.php when an error 404 is reached. If this file is not present, then it will give a basic error message which is not user-friendly.

If you do not already have this file you can create it. Make a new blank file and name it 404.php

Here is the basic code we will start with:

404.php File

<?php get_header(); ?>

	<h2>Error 404 - Page Not Found.</h2>

<?php get_sidebar(); ?>

<?php get_footer(); ?>

The above code within the 404.php file would give a simple output wrapped in H2 tags that would read “Error 404 – Page Not Found.” – It would also get the WordPress Header, Sidebar, and Footer. These are all optional and should be modified to fit your WordPress theme.

We want to take this a few steps further to achieve our goal. Make a note that I am using the get_header() along with get_sidebar and footer to call our theme template files. Your’s may vary slightly and you will have to adjust your 404.php file accordingly.

Starting to work on it

First, We will add the search form to our basic 404 page to make it a bit more helpful. This way even if a visitor lands on your 404, they then have the option of searching your site. This is the first method to help users stick around instead of leaving.

404.php File – Added Search Form

<?php get_header(); ?>

    	<h2>Error 404 - Page Not Found.</h2>

<?php include(TEMPLATEPATH . "/searchform.php"); ?>

<?php get_sidebar(); ?>

<?php get_footer(); ?>

Making it more dynamic

To create a more dynamic error 404 page you can use redirects so that the user only sees the error briefly, then gets redirected to your home page. This page can be made to be somewhat SEO friendly as well.

For this next example we can start by editing the header.php file of your template. Within the meta tags at the top of your header.php file you can add the following:

header.php File

if (is_404()) {
 $redirectHome = get_option('home'); ?>
<?php echo $redirectHome; ?>

After this is added we will then edit our 404.php file to look like this:

404.php File

<?php get_header(); ?>
<h1>Error 404 - File Not Found.</h1>
<h3>Please <a href="<?php bloginfo('home'); ?>" Click here</a> to return to our home page, or you can wait to be redirected in 15 seconds.</h3>
<?php get_footer(); ?>

The above example will allow the user to land on the 404 error page but then automatically take them back to the home page. This will also help users stick around instead of them being left confused and leaving your website. This example may not always be the best solution for everyone but can be helpful to someone looking for something specific on your site.

Making sure it works

You can test your 404 error page by typing your URL and following it with a page that you know does not exist.


That should bring you to your 404 page for viewing and testing.

If it doesn’t work

If by chance your server is not automatically bringing you to your 404.php file we can modify our .htaccess file to make it work. Locate your .htaccess file within your WordPress install and add the following line to it:

ErrorDocument 404 /index.php?error=404

If your WordPress install is not in the root directory you will need to make sure the above code reflects that. If you have installed WordPress into a sub folder then modify your .htaccess like this:

ErrorDocument 404 /YOURSUBFOLDERNAME/index.php?error=404

This will force the use of your 404.php file.

A full example

The code below is a full demonstration that will show you some ways you can use the 404.php file to help users that have found something that doesn’t exist. Take a look at it and notice the options we are giving them to keep them around, and to help them find content.

<?php get_header(); ?>

	<h1>404 Error</h1>

	<p>We cannot seem to find what you were looking for.</p>
	<p>Maybe we can still help you.</p>

		<li>You can search our site using the form provided below.</li>

	<li>You can visit <a href="<?php bloginfo?>"</a></li>
<a href="<?php ('url'); ?>" the homepage.</a>
		<li>Or you can view some of our recent posts.</li>

	TEMPLATEPATH . "/searchform.php"); ?>

	<h3>Recent Posts</h3>

	if (have_posts()) : while (have_posts()) : the_post(); ?>
	<li><a href="<?php the_permalink() ?>" title="Permalink for : <?php the_title(); ?>"><?php the_title(); ?></a>
	endwhile; endif; ?>

<?php get_footer(); ?>

Anything above can be changed and styled to fit your needs. In the above example we are displaying that there was an error, and then following it with a list of options for the user. We are also still giving them the option to search our site, and have now added the ability for them to view our recent posts. The combination of all of these gives the user that reached the page options. These options can be used to ensure a user doesn’t leave right away if they didn’t find exactly what they wanted.

Make it More User Friendly

To make it more user friendly and unique you could consider using the above examples with a different background image of your choice. You can also use html within the 404.php file to make a page all in itself for your error page. Here are some examples of unique error 404 pages for inspiration:











Using it Wisely

It is always good practice for both WordPress and static HTML sites to make use of the 404 page. Either using ads on it to monetize, or using it to better help your visitors navigate your website. There are many ways to create your own custom 404 error page, and just as many ways to allow it to help website visitors. Use the examples above freely, and experiment with what works best for you.



  1. Jason Lee

    Ohh i like. Some pages are really cool. My favorites are number 9 and number 4
    I’ll try to create a nice custom 404 too, thanks for your help !!

  2. Lester

    This page really helped me alot. I have created a custom 404 page and I don’t think I could have done it without the direction above.
    Thanks so much

  3. I like’s 404 page. I don’t bother too much for 404 page design. I would rather focus more on the main page design than be creative for 404 page. After all it is error and people end up on this page when they can’t find it.

  4. It is also a good practice to log the referring URLs. This will help you to understand where the broken link was and go back to fix it.

    Nice 404 collection gallery, thanks Kevin

  5. Lasik Doctors

    It’s really very annoying for me to found out that I will only land to an error 404 site. Pretty much disappointing when I really need to have a particular info from that site alone. Though the design can’t actually result to a solution, it’s still good to see interesting images in this site.

  6. Natalie Port

    Thank you for another great article. Where else could anyone net that kind of advice in such a best acknowledge proceeding of writing? I be undergoing a display next week, and I am on the look for such information.

  7. Queen

    Great article Kevin…I especially like the navigation part. One thing I’ve been doing with my 404 pages is adding a relevant offer and have been seeing sales from the error pages.

    I have not however created 404 error pages for my blogs so this article will assist me with that.

  8. JC Johnston

    I need to add a 404 page. Thanks for the tutorial, been looking to make my own custom one for a while.

  9. Patz Illustrated

    Nice!!! Just finished my site today and considered doing a 404 page but don’t know how…this is exactly what I needed.

  10. Abdelhadi Touil

    WordPress is the best for me :)
    Great tips for creating a custom 404 page using wordpress.
    Thanks very much for these ideas.

  11. Matt

    Nice tutorial, except that I was JUST about to write one almost identical. Like today, haha. Great minds, yes? Anyway a useful 404 page is extremely important and something that is overlooked. A 404 doesn’t have to mean a bounce, it can be another opportunity to provide a good user experience.

  12. Albert Lie

    Very nice informations! I’ve been looking for this. This article will provide more design aspects for every blog instead of error 404 message. Thanks Kevin!