deprecated

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.

`deprecated`

1.36

The deprecated tag was added in Twig 1.36.

Twig generates a deprecation notice (via a call to the trigger_error() PHP function) where the deprecated tag is used in a template:

        1
2
3
        {# base.twig #}
{% deprecated 'The "base.twig" template is deprecated, use "layout.twig" instead.' %}
{% extends 'layout.twig' %}
    

Also you can deprecate a block in the following way:

        1
2
3
4
5
6
7
8
        {% block hey %}
    {% deprecated 'The "hey" block is deprecated, use "greet" instead.' %}
    {{ block('greet') }}
{% endblock %}

{% block greet %}
    Hey you!
{% endblock %}
    

Note that by default, the deprecation notices are silenced and never displayed nor logged. See Recipes to learn how to handle them.