How To Configure Apache2 to Use Custom Error Pages on Ubuntu

Why to Create a Custom 404 Page

A custom 404 page lets you provide a user-friendly website to your visitors. Only few users, when presented with a 404, will do more beyond click back to get out of the mistake. A custom 404 page is a good opportunity to keep them on your site and do more to redirect them to their destination.

Creating your custom error page

Now let’s dive in adding a custom error page to your site.

Sample Code:

<!doctype html>

<a href=”index.html” class=”err-btn”>HOMEPAGE <i class=”fas fa-angle-right”></i></a>


You can also make your own version of 404 html page more visually appealing

Implement the 404 Page

Now that you have your custom error page coded (referred to as 404.html from here on), Now quickly go to the home directory /var/www/html/.

The next step is editing your Apache localized-error-pages file to use 404.html instead of the default error page.

Locate your  localized-error-pages configuration file in the /etc/apache2/conf-available/ directory. The file will be called localized-error-pages.conf 

Now you can see there are different types of error pages that can be overridden. Just uncomment line 8 that starts with “ErrorDocument 404” and add “/404.html” instead of the default location for that error page. You can simply repeat this or create different custom error pages for each type of error.

Save and Exit Once Done

ErrorDocument 404 /404.html

Now the last step is to restart your Apache server in order for the changes to take effect:

sudo service apache2 restart

See the 404 Page

Now visiting unavailable pages on your site should display your custom 404 page!

Looking for a Top Rated* Marketing Company?

Contact us at +1 630 999 SPOT (7768) or submit a business inquiry online.

Looking for a Cloud Expert with Marketing Bent of Mind