Template includes for reusability in Django - Performance & Optimization

Performance: Template includes for reusability

MEDIUM IMPACT

This affects page load speed by reducing template parsing time and improving rendering efficiency through reusable components.

Reusing common HTML parts like headers or footers across multiple pages

Django

{% comment %} Use {% include %} to reuse header {% endcomment %}
{% include 'partials/header.html' %}

Template engine parses the header once and reuses it, reducing parsing and improving maintainability.

📈 Performance GainReduces template parsing time and memory usage, improving LCP.

Reusing common HTML parts like headers or footers across multiple pages

Django

{% comment %} Copy-pasting header HTML in every template {% endcomment %}
<header>
  <h1>Site Title</h1>
  <nav>...</nav>
</header>

Duplicated code increases template size and parsing time, making maintenance harder and slowing down rendering.

📉 Performance CostIncreases template parsing time linearly with number of pages, causing slower LCP.

Performance Comparison

Pattern	DOM Operations	Reflows	Paint Cost	Verdict
Copy-pasting HTML in every template	More DOM nodes sent repeatedly	Multiple reflows due to larger HTML	Higher paint cost due to bigger DOM	[X] Bad
Using {% include %} for common parts	Reused DOM nodes efficiently	Single reflow per included part	Lower paint cost due to smaller HTML	[OK] Good

Rendering Pipeline

Template includes reduce the amount of duplicated HTML code the server must parse and send, which speeds up server-side rendering and reduces the size of the HTML sent to the browser.

→Template Parsing

→HTML Generation

→Network Transfer

⚠️ BottleneckTemplate Parsing on server

Core Web Vital Affected

LCP

This affects page load speed by reducing template parsing time and improving rendering efficiency through reusable components.

Optimization Tips

1Use {% include %} to reuse common HTML parts and reduce template size.

2Avoid copying the same HTML code in multiple templates to prevent slow parsing.

3Smaller, modular templates improve server rendering speed and reduce LCP.

Performance Quiz - 3 Questions

How does using Django template includes affect page load performance?

A It increases the HTML size by duplicating code.

B It reduces template parsing time by reusing common parts.

C It causes more reflows in the browser.

D It blocks JavaScript execution.

DevTools: Network

How to check: Open DevTools > Network tab, reload page, and compare HTML response sizes for pages with and without includes.

What to look for: Smaller HTML size and faster load times indicate better performance with includes.

Practice

1. What is the main purpose of using {% include %} in Django templates?

easy

A. To reuse parts of templates like headers or footers in multiple pages

B. To execute Python code inside the template

C. To define variables for use in the template

D. To create loops inside the template

Solution

1. Step 1: Understand the role of {% include %}

   This tag is used to insert reusable template parts, such as headers or footers, into other templates.

2. Step 2: Compare with other template features

   Executing Python code or defining variables is done differently, not with {% include %}.

3. Final Answer:

   To reuse parts of templates like headers or footers in multiple pages -> Option A

4. Quick Check:

   Template reuse = To reuse parts of templates like headers or footers in multiple pages [OK]

Hint: Remember: include = reuse template parts like header/footer [OK]

Common Mistakes:

• Thinking include runs Python code
• Confusing include with variable assignment
• Using include to create loops

2. Which of the following is the correct syntax to include a template named menu.html inside another template?

easy

A. {% include menu.html %}

B. {% include 'menu.html' %}

C. {% include "menu.html %}

D. {% include 'menu' %}

Solution

1. Step 1: Check the syntax for including templates

   The correct syntax requires the template name as a quoted string inside the include tag, like {% include 'menu.html' %}.

2. Step 2: Evaluate the options

   {% include menu.html %} misses quotes, {% include "menu.html %} malformed double quotes (missing closing quote), {% include 'menu' %} misses the file extension.

3. Final Answer:

   {% include 'menu.html' %} -> Option B

4. Quick Check:

   Include syntax = {% include 'menu.html' %} [OK]

Hint: Include template name in single quotes inside {% include %} [OK]

Common Mistakes:

• Forgetting quotes around template name
• Omitting file extension
• Using variable name without quotes

3. Given the following templates:

{% raw %}{# base.html #}%

  
    {% include 'header.html' %}
    
Welcome
  
{% endraw %}

And header.html contains:

{% raw %}
Menu
{% endraw %}

What will be the rendered output of base.html?

medium

A. Error: header.html not found

B.

{% include 'header.html' %}
Welcome

C.

Menu
Welcome

D.

Menu
Welcome

Solution

1. Step 1: Understand how {% include %} works

   The include tag inserts the full content of header.html into base.html at the include position.

2. Step 2: Replace include with header content

   Replacing {% include 'header.html' %} with <header><nav>Menu</nav></header> gives the full HTML output.

3. Final Answer:

   <html> <body> <header><nav>Menu</nav></header> <h1>Welcome</h1> </body> </html> -> Option D

4. Quick Check:

   Include inserts full template content =
   Menu

   Welcome

   [OK]

Hint: Include inserts full content exactly where placed [OK]

Common Mistakes:

• Expecting include tag to remain in output
• Assuming partial content inserted
• Thinking include causes error if file exists

4. You wrote {% include header.html %} in your template but get a TemplateSyntaxError. What is the most likely cause?

medium

A. Missing quotes around the template name in the include tag

B. The header.html file does not exist

C. You need to use {% extends %} instead of {% include %}

D. You forgot to load the include tag library

Solution

1. Step 1: Identify syntax rules for include

   The template name must be a quoted string inside the include tag, like {% include 'header.html' %}.

2. Step 2: Analyze the error cause

   Omitting quotes causes TemplateSyntaxError because Django expects a string literal.

3. Final Answer:

   Missing quotes around the template name in the include tag -> Option A

4. Quick Check:

   Quotes required for template name = Missing quotes around the template name in the include tag [OK]

Hint: Always put template names in quotes inside {% include %} [OK]

Common Mistakes:

• Forgetting quotes around template name
• Confusing include with extends
• Assuming include tag needs loading

5. You want to create a reusable navigation menu that highlights the current page. You have menu.html included in multiple templates. How can you pass the current page name to menu.html using {% include %}?

hard

A. {% include 'menu.html' current_page='home' %}

B. {% include 'menu.html' only current_page='home' %}

C. {% include 'menu.html' with current_page='home' %}

D. {% include 'menu.html' as current_page='home' %}

Solution

1. Step 1: Recall how to pass variables with include

   Django allows passing variables to included templates using with keyword inside the include tag.

2. Step 2: Check syntax correctness

   The correct syntax is {% include 'menu.html' with current_page='home' %}. Other options are invalid syntax.

3. Final Answer:

   {% include 'menu.html' with current_page='home' %} -> Option C

4. Quick Check:

   Pass variables with 'with' keyword = {% include 'menu.html' with current_page='home' %} [OK]

Hint: Use 'with' keyword to pass variables in {% include %} [OK]

Common Mistakes:

• Omitting 'with' keyword when passing variables
• Using 'only' incorrectly with variables
• Trying to assign variables with 'as'