Tutorials References Exercises Videos Menu
Free Website Get Certified Upgrade

Django 404 (page not found)


Page Not Found

If you try to access a page that does not exist (a 404 error), Django directs you to a built-in view that handles 404 errors.

You will learn how to customize this 404 view later in this chapter, but first, just try to request a page that does not exist.

In the browser window, type 127.0.0.1:8000/masfdfg/ in the address bar.

You will get one of two results:

1:

2:

If you got the first result, you got directed to the built-in Django 404 template.

If you got the second result, then DEBUG = True, and you must set it to False to get directed to the 404 template.

This is done in the settings.py file, in the project folder, in our case the myworld folder, where you also have to specify the host name from where your project runs from:

Example

Set the debug property to False, and allow the project to run from your local host:

myworld/settings.py:

.
.
# SECURITY WARNING: don't run with debug turned on in production!
DEBUG = False

ALLOWED_HOSTS = ['127.0.0.1']
.
.

Important: When DEBUG = False, Django requires you to specify the hosts you will allow this Django project to run from.

In production, this should include your domain name:

ALLOWED_HOSTS = ['127.0.0.1', 'yourdomain.com']

In the browser window, type 127.0.0.1:8000/masfdfg/ in the address bar, and you will get the built-in 404 template:


Customize the 404 Template

Django will look for a file named 404.html in the templates folder, and display it when there is a 404 error.

Create a file in the template folder and name it 404.html:

templates/404.html:

<!DOCTYPE html>
<html>
<title>Wrong address</title>
<body>

<h1>Ooops!</h1>

<h2>I cannot find the file you requested!</h2>

</body>
</html>

In the browser window, type 127.0.0.1:8000/masfdfg/ in the address bar, and you will get the customized 404 template: