Base template for all apps in Django

Question

I have a project with 2 apps

project/
    blog/
        templates/
            index.html
    polls/
        templates/
            index.html
    project/
        templates/
            base.html
            index.html

Now i want that the two apps extends the projects base.html. Is this the way to go? how it is possible and are there better solutions?

There is already an question which is handling this question, but it's only worth mentioning if you dont use split directories: Django project base template

tl;dr: I want to use split directories and want to know how to extend a base template from multiple apps without copying it to every app

This has been answered [here](https://stackoverflow.com/questions/14720464/django-project-base-template/60931532#60931532) — mukesh.kumar, Mar 30 '20 at 13:30

score 50 · Accepted Answer · answered Nov 16 '16 at 21:40

50

In current Django (1.10) TEMPLATE_DIRS is deprecated, so:

Add a templates directory at the project root,

In settings.py find TEMPLATES -> DIRS and add it like this:

TEMPLATES = [
{
    ...
    'DIRS': [(os.path.join(BASE_DIR, 'templates')),],
    ...
}

Add a base.html to that directory.
Extend it wherever you want using {% extends 'base.html' %}

answered Nov 16 '16 at 21:40

Oliver Sosa

754
9
16

1

Thanks for the tip! Not sure when this changed, but `BASE_DIR` is a `pathlib.Path` object, so you could write `BASE_DIR / "templates"` instead of using `os.path.join`. – Nico Bako Dec 23 '21 at 15:45

rnevius · Answer 2 · 2016-11-15T18:05:41.867

8

Add a templates directory at the project root, and add it to your TEMPLATE_DIRS setting.
Add a base.html to that directory.
Extend it wherever you want using {% extends 'base.html' %}

edited Nov 15 '16 at 18:05

answered Apr 07 '15 at 13:23

rnevius

26,578
10
58
86

I've done that, my setting looks like this: `TEMPLATE_DIRS = (os.path.join(BASE_DIR, 'templates/'),)` But that still doesn't work – fechnert Apr 07 '15 at 13:32
4

Get rid of the forward slash. – rnevius Apr 07 '15 at 13:35

score 3 · Answer 3 · answered Jun 15 '17 at 22:49

For Django versions above 1.8 the upgrade doc suggests the vanilla settings (for most non-advanced django tangoers like me) be added to your settings.py:

TEMPLATES = [
    {
        'BACKEND': 'django.template.backends.django.DjangoTemplates',
        'DIRS': [(os.path.join(BASE_DIR, 'my_Templates_Directory')),],
        'APP_DIRS': True,
        'OPTIONS': {
            'context_processors': [
                # Insert your TEMPLATE_CONTEXT_PROCESSORS here or use this
                # list if you haven't customized them:
                'django.contrib.auth.context_processors.auth',
                'django.template.context_processors.debug',
                'django.template.context_processors.i18n',
                'django.template.context_processors.media',
                'django.template.context_processors.static',
                'django.template.context_processors.tz',
                'django.contrib.messages.context_processors.messages',
            ],
        },
    },
]

Both BACKEND and OPTIONS were required, otherwise I had errors relating to 'INVALID BACKEND' and 'django.contrib.auth.context_processors.auth' must be in TEMPLATES'.

Base template for all apps in Django

3 Answers3

Linked