# Templating

URL: /docs/theming/templating/
Section: templating

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

Jinja2 Templating Bengal uses Jinja2 for all templates. If you know Python, you'll feel at home. Template Lookup Order flowchart LR A[Page Request] --&gt; B{templates/ ?} B --&gt;|Found| C[Use Your Template] B --&gt;|Not Found| D{Theme templates/ ?} D --&gt;|Found| E[Use Theme Template] D --&gt;|Not Found| F[Use Bengal Default] Bengal searches: Your project → Theme → Bengal defaults Quick Start Basic Template Base Layout Partial 1 2 3 4 5 6 7 8 9{# templates/layouts/single.html #} &#123;% extends &quot;baseof.html&quot; %&#125; &#123;% block content %&#125; &lt;article&gt; &lt;h1&gt;{{ page.title }}&lt;/h1&gt; {{ page.content | safe }} &lt;/article&gt; &#123;% endblock %&#125; 1 2 3 4 5 6 7 8 9 10 11 12{# templates/baseof.html #} &lt;!DOCTYPE html&gt; &lt;html&gt; &lt;head&gt; &lt;title&gt;&#123;% block title %&#125;{{ page.title }}&#123;% endblock %&#125;&lt;/title&gt; &lt;/head&gt; &lt;body&gt; &#123;% block header %&#125;&#123;% include &quot;partials/header.html&quot; %&#125;&#123;% endblock %&#125; &#123;% block content %&#125;&#123;% endblock %&#125; &#123;% block footer %&#125;&#123;% include &quot;partials/footer.html&quot; %&#125;&#123;% endblock %&#125; &lt;/body&gt; &lt;/html&gt; 1 2 3 4 5 6 7 8{# templates/partials/header.html #} &lt;header&gt; &lt;nav&gt; &#123;% for item in site.menus.main %&#125; &lt;a href=&quot;{{ item.url }}&quot;&gt;{{ item.title }}&lt;/a&gt; &#123;% endfor %&#125; &lt;/nav&gt; &lt;/header&gt; Key Concepts Concept Syntax Purpose Extends &#123;% extends &quot;base.html&quot; %&#125; Inherit from parent template Block &#123;% block name %&#125;...&#123;% endblock %&#125; Replaceable section Include &#123;% include &quot;partial.html&quot; %&#125; Insert another template Variable {{ page.title }} Output a value Filter {{ text \| truncate(100) }} Transform a value Template Inheritance flowchart TB A[&quot;baseof.html&lt;br/&gt;(blocks: head, content, footer)&quot;] B[&quot;single.html&lt;br/&gt;(extends baseof)&quot;] C[&quot;list.html&lt;br/&gt;(extends baseof)&quot;] D[&quot;doc.html&lt;br/&gt;(extends single)&quot;] A --&gt; B A --&gt; C B --&gt; D Tip Tip Override sparingly: You only need to create templates you want to customize. Start by copying one template from your theme, modify it, and let the rest fall through to defaults.

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

Metadata:
- Author: lbliii
- Word Count: 281
- Reading Time: 1 minutes