Twig

The flexible, fast, and secure
template engine for PHP

a Symfony Product
Docs Tags deprecated
You are reading the documentation for Twig 2.x. Switch to the documentation for Twig 1.x. 3.x.
Warning Twig version 2.x end of maintenance is scheduled for December 2023.

Questions & Feedback

License

Twig documentation is licensed under the new BSD license.

deprecated

2.6

The deprecated tag was added in Twig 2.6.

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

You can also deprecate a macro in the following way:

1
2
3
4
5
{% macro welcome(name) %}
    {% deprecated 'The "welcome" macro is deprecated, use "hello" instead.' %}

    ...
{% endmacro %}

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

Note

Don't use the deprecated tag to deprecate a block as the deprecation cannot always be triggered correctly.

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