Django Tutorial · Static Files

Collect Static Files

Learn all about Collect Static Files in this comprehensive tutorial.

5 min read intermediate
  • Static files in your project, like stylesheets, JavaScripts, and images, are not handled automatically by Django when DEBUG = False.
  • To collect all necessary static files for your project, start by specifying a STATIC_ROOT property in the settings.
  • Now you have collected the static files of your project, and if you have installed WhiteNoise, the example from the Add Static Files chapter will finally work.

Handle Static Files

Static files in your project, like stylesheets, JavaScripts, and images, are not handled automatically by Django when DEBUG = False.

When DEBUG = True, this worked fine, all we had to do was to put them in the static folder of the application.

When DEBUG = False, static files have to be collected and put in a specified folder before we can use it.

Collect Static Files

To collect all necessary static files for your project, start by specifying a STATIC_ROOT property in the settings.py file.

This specifies a folder where you want to collect your static files.

You can call the folder whatever you like, we will call it productionfiles:

You could manually create this folder and collect and put all static files of your project into this folder, but Django has a command that do this for you:

python

Which will produce this result:

python

128 files? Why so many? Well this is because of the admin user interface, that comes built-in with Django. We want to keep this feature in production, and it comes with a whole bunch of files including stylesheets, fonts, images, and JavaScripts.

If you check in the filesystem on your computer, you will see that a new folder was created: productionfiles. This folder contains admin, with the static files for the admin UI, and the myfirst.css file you created in the Add Static Files chapter.

python

The Example Should Work

Now you have collected the static files of your project, and if you have installed WhiteNoise, the example from the Add Static Files chapter will finally work.

Start the server and see the result:

python

And check out the result in your own browser: 127.0.0.1:8000/testing/.

Module quiz

2 questions
1

Which of the following is true about Collect Static Files?

2

What is the most common pitfall when working with Collect Static Files?

Answer all questions to submit.