# Includes

URL: /docs/syntax/includes/
Section: syntax
Tags: syntax, includes

--------------------------------------------------------------------------------

Includes Include reusable template fragments (partials) in your templates. Basic Include &#123;% include &quot;partials/header.html&quot; %&#125; &lt;main&gt; Content here &lt;/main&gt; &#123;% include &quot;partials/footer.html&quot; %&#125; Context Inheritance Included templates have access to the current context: {# page.html #} &#123;% set user = get_current_user() %&#125; &#123;% include &quot;partials/user-card.html&quot; %&#125; {# partials/user-card.html #} &lt;div class=&quot;user-card&quot;&gt; &lt;h3&gt;{{ user.name }}&lt;/h3&gt; &lt;p&gt;{{ user.email }}&lt;/p&gt; &lt;/div&gt; Passing Variables Pass specific variables with with: &#123;% include &quot;components/button.html&quot; with text=&quot;Click Me&quot;, url=&quot;/action&quot; %&#125; {# components/button.html #} &lt;a href=&quot;{{ url }}&quot; class=&quot;button&quot;&gt;{{ text }}&lt;/a&gt; Isolated Context Use only to include with an empty context: &#123;% include &quot;components/widget.html&quot; with title=&quot;Widget&quot; only %&#125; The included template only sees title, not the parent context. Ignore Missing Skip if the template doesn't exist: &#123;% include &quot;optional/sidebar.html&quot; ignore missing %&#125; With fallback: &#123;% include [&quot;theme/header.html&quot;, &quot;default/header.html&quot;] %&#125; Kida tries each template in order, using the first one found. Dynamic Includes Include based on a variable: &#123;% include component_name %&#125; {# Or with string concatenation #} &#123;% include &quot;components/&quot; + widget_type + &quot;.html&quot; %&#125; Include vs Extends Aspect &#123;% include %&#125; &#123;% extends %&#125; Purpose Embed a fragment Inherit structure Context Shares parent context Isolated Blocks Cannot override blocks Overrides blocks Use case Components, partials Page layouts Common Patterns Component Library templates/ ├── components/ │ ├── button.html │ ├── card.html │ ├── modal.html │ └── nav.html └── pages/ └── home.html {# pages/home.html #} &#123;% include &quot;components/nav.html&quot; %&#125; &lt;main&gt; &#123;% for item in items %&#125; &#123;% include &quot;components/card.html&quot; with item=item %&#125; &#123;% end %&#125; &lt;/main&gt; Conditional Includes &#123;% if user.is_admin %&#125; &#123;% include &quot;admin/toolbar.html&quot; %&#125; &#123;% end %&#125; &#123;% if show_sidebar %&#125; &#123;% include &quot;partials/sidebar.html&quot; %&#125; &#123;% end %&#125; Loop Includes &#123;% for post in posts %&#125; &#123;% include &quot;partials/post-card.html&quot; with post=post %&#125; &#123;% end %&#125; Performance Included templates are cached just like regular templates. The compilation cost is paid once, then reused. # Templates are compiled once and cached env = Environment(loader=FileSystemLoader(&quot;templates/&quot;)) env.cache_info() # Shows template cache stats See Also Inheritance — Template inheritance Functions — Reusable functions Loading Templates — Template loaders

--------------------------------------------------------------------------------

Metadata:
- Word Count: 336
- Reading Time: 2 minutes