Skip to main content

Add macros to your django templates

Project description

PyPI Version


Add macros to your django templates


The original code of this app is taken from by MattP.

This snippets cites:

Based on snippet by
    Michal Ludvig <>

Extended for args and kwargs into templatetags/ by
    Skylar Saveland <>

Modified to support rendering into context by


You can find this package here:


  1. Add this app “macros” to your INSTALLED_APPS

  2. In your template load the library:

    {% load macros %}
  3. Define a new macro called ‘my_macro’ that takes args and/or kwargs All will be optional:

    {% macro my_macro arg1 arg2 baz="Default baz" %}
        {% firstof arg1 "default_arg1" %}
        {% if arg2 %}{{ arg2 }}{% else %}default_arg2{% endif %}
        {{ baz }}
    {% endmacro %}
  4. Use the macro with string parameters or context variables:

    {% usemacro my_macro "foo" "bar" baz="KW" %}
    {% usemacro my_macro num_pages "bar" %}

Renders like:

foo bar KW
77 bar Default baz
  1. Alternatively save your macros in a separate file, e.g. “mymacro.html” and load it to the current template with:

        {% loadmacros "mymacros.html" %}
    Then use these loaded macros in as described above.

Bear in mind that defined and loaded macros are local to each template file and are not inherited through {% extends … %} tags.

  1. When recursive macros are needed, use the ‘recurse_macro’ template tag:

    {% macro MENU entries %}
        {% for entry in entries %}
            <a href="{{ }}"> {{ entry.label }} </a>
            {% if entry.children %}
                {% recurse_macro MENU entry.children %}
            {% endif %}
        {% endfor %}
    {% endmacro %}
    {% usemacro MENU menu.children %}

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

django-templates-macros-0.3.tar.gz (5.1 kB view hashes)

Uploaded source

Built Distribution

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page