Include for reusable fragments in Flask - Step-by-Step Execution

Concept Flow - Include for reusable fragments

Start Template Rendering

↓

Encounter {% include 'file.html' %}

↓

Load included file content

↓

Render included content in place

↓

Continue rendering main template

↓

Finish Template Rendering

When rendering a template, Flask sees an include statement, loads the included file, inserts its content, then continues rendering the main template.

Execution Sample

Flask

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

This template inserts the content of header.html, then shows a welcome message, then inserts footer.html.

Execution Table

Step	Action	Template Part	Result
1	Start rendering main template	main.html	Begin processing main.html
2	Find include statement	{% include 'header.html' %}	Prepare to insert header.html content
3	Load header.html	header.html	Read header.html content
4	Render header.html content	header.html	Insert header content into main template
5	Continue rendering main template	<p>Welcome to my site!</p>	Add welcome paragraph
6	Find include statement	{% include 'footer.html' %}	Prepare to insert footer.html content
7	Load footer.html	footer.html	Read footer.html content
8	Render footer.html content	footer.html	Insert footer content into main template
9	Finish rendering main template	main.html	Complete full page with header, content, footer

💡 All includes processed and main template fully rendered

Variable Tracker

Variable	Start	After Step 4	After Step 5	After Step 8	Final
Rendered HTML	""	"<header>...</header>"	"<header>...</header><p>Welcome to my site!</p>"	"<header>...</header><p>Welcome to my site!</p><footer>...</footer>"	Full combined HTML content

Key Moments - 3 Insights

Why does the included file content appear exactly where the include statement is?

Because Flask replaces the include statement with the content of the included file during rendering, as shown in steps 3 and 4 of the execution_table.

Can included files themselves contain include statements?

Yes, included files can have their own include statements, which Flask will process recursively during rendering.

What happens if the included file does not exist?

Flask will raise a template error and stop rendering, because it cannot find the file to include.

Visual Quiz - 3 Questions

Look at the execution table, what is the rendered HTML content after step 5?

A "<header>...</header><p>Welcome to my site!</p>"

B "<p>Welcome to my site!</p>"

C "<footer>...</footer>"

D "<header>...</header>"

💡 Hint

Check the 'Rendered HTML' variable in variable_tracker after step 5

At which step does Flask insert the footer content into the main template?

A Step 6

B Step 8

C Step 4

D Step 9

💡 Hint

Look at the execution_table row where footer.html content is rendered

If the include statement for header.html was removed, how would the rendered HTML after step 5 change?

A It would contain header and footer content

B It would cause an error

C It would only contain the welcome paragraph without header content

D It would be empty

💡 Hint

Refer to variable_tracker and consider what content is added at step 4

Concept Snapshot

Flask's {% include 'file.html' %} inserts reusable HTML fragments.
It loads the included file content and places it exactly where the include is.
Includes can be nested and help avoid repeating code.
If the file is missing, rendering stops with an error.
Use includes to keep templates clean and DRY.

Full Transcript

When Flask renders a template with an include statement, it pauses rendering the main template to load the included file. It then inserts the included file's content exactly where the include statement was. After that, it continues rendering the rest of the main template. This process allows you to reuse common parts like headers and footers across pages. If the included file is missing, Flask will raise an error and stop rendering. Includes can also be nested, meaning included files can themselves include other files. This helps keep templates organized and avoids repeating the same HTML in multiple places.