{% include %} Tag

used to include one template in another.

Utility Most Useful As Markdown

Closing tag
Not required

Documentation

Used to include one template in another.

Parent Template

{% block main %}
  <p>Content before include</p>
  {% include 'asides/book-ad.html' %}
  <p>Content after include</p>
{% endblock main %}

Included Template: templates/asides/book-ad.html

<aside>
  <p><strong>Read our Python Book!</strong></p>
</aside>

Result

<p>Content before include</p>
  <aside>
    <p><strong>Read our Python Book!</strong></p>
  </aside>
<p>Content after include</p>

Commentary

This should not be used to include headers and footers. Use Template Inheritance for that kind of thing. Use the include tag to include asides or callouts that show up on some, but not all pages.

Pagination Include

A great use case for the include tag is pagination, which could go on any ListView template. Here is a Bootstrap pagination nav:

<nav aria-label="pagination">
  <ul class="pagination justify-content-center">
    {% if page_obj.has_previous %}
      <li class="page-item">
        <a class="page-link" href="?page=1">&laquo; 1…</a>
      </li>
      {% if page_obj.previous_page_number != 1 %}
        <li class="page-item">
          <a class="page-link" href="?page={{ page_obj.previous_page_number }}">
            {{ page_obj.previous_page_number }}
          </a>
        </li>
      {% endif %}
    {% endif %}
    <li class="page-item active">
      <span class="page-link">
        {{ page_obj.number }}
      </span>
    </li>
    {% if page_obj.has_next %}
      {% if page_obj.next_page_number != page_obj.paginator.num_pages %}
        <li class="page-item">
          <a class="page-link" href="?page={{ page_obj.next_page_number }}">
            {{ page_obj.next_page_number }}
          </a>
        </li>
      {% endif %}
      <li class="page-item">
        <a class="page-link" href="?page={{ page_obj.paginator.num_pages }}">
          …{{ page_obj.paginator.num_pages }} &raquo;
        </a>
      </li>
    {% endif %}
  </ul>
</nav>

The resulting nav will look like this:

More Utility Tags

block comment csp_nonce_attr csrf_token debug extends filter load lorem now partial partialdef querystring regroup url

All Utility Tags

Did we get something wrong? Is there a use case for the include tag that we should add? Please let us know.

Send Feedback
Official Documentation
This page last updated on August 2, 2026