block

You are reading the documentation for Twig 1.x. Switch to the documentation for Twig 2.x, 3.x.

Warning Twig version 1.x is no longer maintained.

Questions & Feedback

Found a typo or an error?
Want to improve this document? Edit it.

Need support or have a technical question?
Ask support on Stack Overflow.

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 %}
    