Twig

The flexible, fast, and secure
template engine for PHP

a Symfony Product
Docs Functions block
You are reading the documentation for Twig 1.x. Switch to the documentation for Twig 2.x. 3.x.

Questions & Feedback

License

Twig documentation is licensed under the new BSD license.

block

New in version 1.28

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

New in version 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

Website powered by Symfony and Twig, deployed on
The Twig logo is © 2010-2021 Symfony