Twig

The flexible, fast, and secure
template engine for PHP

a Symfony Product
Docs Functions block
Docs for Twig version 1.x
Switch to another version: 2.x, 3.x
⚠️ Version 1.x is not maintained.

Questions & Feedback

License

Twig documentation is licensed under the new BSD license.

block

1.28

Using block with the defined test was added in Twig 1.28.

1.28

Support for the template argument was added in Twig 1.28.

When a template uses inheritance and if you want to print a block multiple times, use the block function:

1
2
3
4
5
<title>{% block title %}{% endblock %}</title>

<h1>{{ block('title') }}</h1>

{% block body %}{% endblock %}

The block function can also be used to display one block from another template:

1
{{ block("title", "common_blocks.twig") }}

Use the defined test to check if a block exists in the context of the current template:

1
2
3
4
5
6
7
{% if block("footer") is defined %}
    ...
{% endif %}

{% if block("footer", "common_blocks.twig") is defined %}
    ...
{% endif %}

See also

extends, parent