embed construct

The embed construct works like a multiple inheritance mechanism, allowing developers to include and extend parent templates in one go.

{% embed resourceExpression ignore missing with mapExpression only %}
  {% block blockId %}
    ... redefine template ...
  {% endblock %}
{% endembed %}

Functionality wise, this construct is the result of merging the include feature with the extends one.

Inside an embed tag one can only specify block tags which will override the parent template included.


The embed arguments are exactly the same as the include construct and have identical behaviour.