Home » Documentation » Tags » filter spaceless raw inherit overrules all catinclude catinclude cache with _ extended translation media image_url image print url call comment autoescape ifnotequal ifequal if for block cycle lib now all include include extends trans

block

Overrule a block from an inherited template.

The {% block %} tag is used for replacing blocks in inherited templates.  See also template inheritance, {% extends %} and {% overrules %}.

For example, when we have a template “base.tpl”:

Hello {% block name %}my{% endblock %} world.

And we render the template:

{% extends "base.tpl" %}
{% block name %}Peter's{% endblock %}

Then the output will be:

Hello Peter's world.

Though when we render the template:

{% extends "base.tpl" %}

then the output will be:

Hello my world.

The name of a block must be a valid identifier.