Template includes for reusability in Django - Step-by-Step Execution

Concept Flow - Template includes for reusability

Main Template

↓

Include Tag Found

↓

Load Included Template

↓

Render Included Template Content

↓

Insert Included Content into Main Template

↓

Render Complete Page

The main template finds an include tag, loads the included template, renders its content, and inserts it back into the main template before rendering the full page.

Execution Sample

Django

{% include 'header.html' %}
<p>Welcome to my site!</p>
{% include 'footer.html' %}

This template includes header.html and footer.html templates inside the main template to reuse common page parts.

Execution Table

Step	Action	Template Processed	Output Inserted	Resulting Content
1	Start rendering main template	main.html	None	{% include 'header.html' %} <p>Welcome to my site!</p> {% include 'footer.html' %}
2	Find include tag for header.html	main.html	Load header.html	<header><h1>Site Title</h1></header> <p>Welcome to my site!</p> {% include 'footer.html' %}
3	Render header.html content	header.html	<header><h1>Site Title</h1></header>	<header><h1>Site Title</h1></header> <p>Welcome to my site!</p> {% include 'footer.html' %}
4	Find include tag for footer.html	main.html	Load footer.html	<header><h1>Site Title</h1></header> <p>Welcome to my site!</p> <footer><p>© 2024 MySite</p></footer>
5	Render footer.html content	footer.html	<footer><p>© 2024 MySite</p></footer>	<header><h1>Site Title</h1></header> <p>Welcome to my site!</p> <footer><p>© 2024 MySite</p></footer>
6	Complete rendering main template	main.html	Full content	<header><h1>Site Title</h1></header> <p>Welcome to my site!</p> <footer><p>© 2024 MySite</p></footer>

💡 All include tags replaced by their respective template contents; main template fully rendered.

Variable Tracker

Variable	Start	After Step 2	After Step 3	After Step 4	After Step 5	Final
main_template_content	{% include 'header.html' %} <p>Welcome to my site!</p> {% include 'footer.html' %}	<header><h1>Site Title</h1></header> <p>Welcome to my site!</p> {% include 'footer.html' %}	<header><h1>Site Title</h1></header> <p>Welcome to my site!</p> {% include 'footer.html' %}	<header><h1>Site Title</h1></header> <p>Welcome to my site!</p> <footer><p>© 2024 MySite</p></footer>	<header><h1>Site Title</h1></header> <p>Welcome to my site!</p> <footer><p>© 2024 MySite</p></footer>	<header><h1>Site Title</h1></header> <p>Welcome to my site!</p> <footer><p>© 2024 MySite</p></footer>

Key Moments - 3 Insights

Why does the main template content change after step 2?

Because the include tag {% include 'header.html' %} is replaced by the actual content of header.html, as shown in execution_table rows 2 and 3.

What happens if the included template file is missing?

Django will raise a TemplateDoesNotExist error and stop rendering, so the include tag cannot be replaced, unlike the smooth replacement shown in the execution_table.

Can included templates have their own include tags?

Yes, included templates can include other templates, and Django will process them recursively until all includes are resolved, similar to the main template process.

Visual Quiz - 3 Questions

Look at the execution_table at step 3, what content replaces the include tag?

A <footer><p>© 2024 MySite</p></footer>

B <header><h1>Site Title</h1></header>

C <p>Welcome to my site!</p>

D {% include 'footer.html' %}

💡 Hint

Check the 'Output Inserted' column at step 3 in the execution_table.

At which step does the footer.html content get inserted into the main template?

A Step 5

B Step 2

C Step 4

D Step 6

💡 Hint

Look at the 'Action' and 'Template Processed' columns in the execution_table for footer.html rendering.

If the main template had no include tags, how would the execution_table change?

A The footer.html would still be loaded.

B The main template content would be empty.

C There would be no steps for loading included templates.

D The rendering would fail.

💡 Hint

Refer to the steps involving include tags in the execution_table.

Concept Snapshot

Django template includes let you reuse parts by inserting other templates.
Use {% include 'file.html' %} inside your main template.
Django replaces the include tag with the included template's content.
This keeps templates clean and avoids repetition.
If the included file is missing, rendering stops with an error.
Includes can be nested for complex layouts.

Full Transcript

In Django templates, you can reuse common parts by using the include tag. When rendering, Django finds the include tag, loads the specified template file, renders its content, and inserts it into the main template. This process repeats for each include tag until the full page is rendered. For example, including header.html and footer.html inserts their content into the main template, so you don't repeat code. If an included file is missing, Django stops rendering with an error. Included templates can also include other templates, allowing nested reuse. This method keeps your templates organized and easy to maintain.