---
title: '{% include %}'
description: used to include one template in another.
date: '2026-08-02'
categories:
  - Template Tag
  - Utility
canonical: https://coolify.djangotemplatetagsandfilters.com/tags/include/
doc_link: https://docs.djangoproject.com/en/6.0/ref/templates/builtins/#include
---

# {% include %}

used to include one template in another.

## Documentation

Used to include one template in another.

### Parent Template

```django
{% 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`

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

### Result

```django
<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](/tags/extends/) 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:

```django
<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">« 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 }} »
        </a>
      </li>
    {% endif %}
  </ul>
</nav>
```

The resulting nav will look like this:

- [« 1…](javascript:alert('just a demo');)
- [2](javascript:alert('just a demo');)
- 3
- [4](javascript:alert('just a demo');)
- […60 »](javascript:alert('just a demo');)