File: libs/Twig/doc/tags/sandbox.rst

``sandbox``
===========

The ``sandbox`` tag can be used to enable the sandboxing mode for an included
template, when sandboxing is not enabled globally for the Twig environment:

.. code-block:: jinja

    {% sandbox %}
        {% include 'user.html' %}
    {% endsandbox %}

.. warning::

    The ``sandbox`` tag is only available when the sandbox extension is
    enabled (see the :doc:`Twig for Developers<../api>` chapter).

.. note::

    The ``sandbox`` tag can only be used to sandbox an include tag and it
    cannot be used to sandbox a section of a template. The following example
    won't work:

    .. code-block:: jinja

        {% sandbox %}
            {% for i in 1..2 %}
                {{ i }}
            {% endfor %}
        {% endsandbox %}