deprecated ¶

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.