WordPress 404 Redirect to Home

Redirect 404 errors to the homepage in WordPress by adding a simple code snippet to your functions.php file. Improve user experience and keep visitors engaged by preventing broken links from leading to dead ends.

Handling 404 errors efficiently is crucial for maintaining a positive user experience on your website. If a visitor lands on a page that doesn’t exist, instead of showing a 404 error page, you can automatically redirect them to the homepage. This approach helps to keep users on your site, reduces bounce rates, and improves overall navigation. Below is a simple snippet that you can add to your WordPress theme’s functions.php file to automatically redirect all 404 errors to your homepage.

How to Redirect 404 Errors to the Homepage

To achieve this, you can use the template_redirect action hook, which runs just before WordPress includes the template file. By checking if the current page is a 404 error, you can use the wp_redirect() function to redirect the visitor to the homepage.

/**
 * Redirect 404 errors to the homepage.
 *
 * This function checks if the current query is a 404 error and,
 * if so, redirects the user to the site's homepage with a 301
 * permanent redirect status.
 */
function homepage_redirect_404() {
    global $wp_query;

    // Check if the current query is a 404 error
    if ( $wp_query->is_404 ) {
        // Redirect to the homepage with a 301 status code
        wp_redirect( get_bloginfo( 'wpurl' ), 301 );
        exit; // Always call exit after redirect to stop further execution
    }
}

// Hook the function to run before the template is loaded
add_action( 'template_redirect', 'homepage_redirect_404', 1 );

How It Works

• Global Query Object: We use the global $wp_query object to check whether the current request resulted in a 404 error using the $wp_query->is_404 condition.
• Redirect Function: If a 404 error is detected, the wp_redirect() function is called to send the visitor to the homepage URL. The second parameter (301) specifies that this is a permanent redirect.
• Exit Function: After the redirect, it’s important to call exit to ensure that no further code is executed and the redirect happens immediately.

Why Use a 301 Redirect?

In this case, a 301 redirect is used, which tells search engines that the page has been permanently moved to the homepage. This can be beneficial for SEO, ensuring that any backlinks or traffic to the 404 page are redirected to a valid page (your homepage).

Conclusion

By adding this simple snippet to your theme’s functions.php file, you can easily handle 404 errors by redirecting users to your homepage. This approach helps retain visitors and improves user experience by ensuring they aren’t met with a frustrating 404 error page. Just be sure to test the functionality after adding the code to ensure that it works smoothly on your site.