How to Configure Error 404 Page in Apache Server: A Step-by-Step
Guide
Have you ever clicked a link on a website and seen a 404 - Page Not
Found error? This happens when the requested webpage cannot be found on the
server.
Instead of showing a plain error message, you can create a custom 404
Error Page that guides visitors back to your website. A well-designed 404
page improves the user experience and makes your website look more
professional.
In this guide, you'll learn how to configure a custom Error 404 page on
an Apache Server in a few simple steps.
What is a 404 Error?
A 404 Error means the server cannot find the webpage requested
by the visitor.
This usually happens because:
- The page was
deleted.
- The page was moved
to another location.
- The URL was typed
incorrectly.
- A broken link points
to a page that no longer exists.
A custom 404 page helps visitors continue browsing instead of leaving
your website.
Before You Begin
Make sure you have:
- A website hosted on
an Apache Server.
- Access to your
website files.
- Permission to edit
the .htaccess file or the Apache configuration.
Step 1: Create a Custom 404 Page
Create a new file named:
404.html
You can also use 404.php if your website uses PHP.
Add a simple message like this:
<!DOCTYPE html>
<html>
<head>
<title>Page Not
Found</title>
</head>
<body>
<h1>Oops! Page Not
Found</h1>
<p>Sorry, the page you
are looking for does not exist.</p>
<a
href="/">Return to Homepage</a>
</body>
</html>
You can customize the page by adding:
- Your company logo
- Navigation menu
- Search box
- Contact information
- Links to popular
pages
Step 2: Upload the 404 Page
Upload 404.html to your website's root folder.
For most websites, this folder is named:
public_html
or
htdocs
depending on your hosting provider.
Step 3: Open the .htaccess File
Locate the .htaccess file in your website's root directory.
If the file does not exist, create a new file and name it:
.htaccess
This file allows you to control how Apache handles requests.
Step 4: Add the ErrorDocument Directive
Open the .htaccess file using a text editor.
Add the following line:
ErrorDocument 404 /404.html
If your error page is inside a folder named errors, use:
ErrorDocument 404 /errors/404.html
Save the file after making the changes.
Step 5: Restart Apache (If Required)
Many shared hosting providers apply changes automatically.
If you manage your own server, restart Apache for the changes to take
effect.
For Linux servers, you can use:
sudo systemctl restart apache2
or
sudo systemctl restart httpd
depending on your operating system.
Step 6: Test Your Custom 404 Page
Open your website in a web browser.
Now enter a web address that does not exist, for example:
https://www.yourwebsite.com/unknownpage
If everything is configured correctly, your custom 404.html page
will appear instead of the default Apache error page.
Tips for a Better 404 Page
A good custom 404 page should:
- Explain that the
page cannot be found.
- Include a link back
to the homepage.
- Match your website's
design.
- Offer links to
important pages.
- Include a search box
if available.
- Keep the message
friendly and simple.
A helpful 404 page encourages visitors to stay on your website instead
of leaving.
Common Problems
The default Apache error page still appears.
Check that:
- The .htaccess
file is in the correct folder.
- The file is named
exactly .htaccess.
- The ErrorDocument
path is correct.
- Apache allows .htaccess
overrides.
I get another error instead.
Verify that:
- The 404.html
file exists.
- File permissions are
correct.
- There are no typing
mistakes in the configuration.
Conclusion
A custom 404 Error Page is a simple improvement that creates a better
experience for your visitors. Instead of displaying a generic server message,
you can guide users back to useful content on your website.
By creating a 404.html page, adding the ErrorDocument
directive to your .htaccess file, and testing the configuration, you can
easily customize how Apache handles missing pages.
Whether you manage a personal blog, business website, or online store,
a professional 404 page helps keep visitors engaged and improves your website's
overall usability.
Frequently Asked Questions (FAQs)
1. What is a 404 Error?
A 404 Error means the requested webpage cannot be found on the server.
2. Where should I place the 404 page?
Place the file in your website's root directory or another folder
referenced in the ErrorDocument directive.
3. What is the ErrorDocument directive?
It is an Apache configuration command that tells the server which page
to display when a specific error occurs.
4. Can I use a PHP page instead of HTML?
Yes. You can use 404.php if your website is built with PHP.
Update the configuration accordingly, for example:
ErrorDocument 404 /404.php
5. Do I always need to restart Apache?
Not always. Shared hosting providers usually apply changes automatically, while self-managed servers may require an Apache restart.