Last updated August 23, 2015. Created on February 2, 2013.
Edited by japo32, wesruv, dawehner, Cottser. Log in to edit this page.

The Twig templating engine offers a debug tool.

The Drupal 8 implementation also adds an additional tool that allows you to locate the template that outputs the markup.

Enable debugging

You enable Twig Debugging in sites/default/services.yml.

Set the debug variable to true:

parameters:
  twig.config:
    debug: true

In firebug make sure that "Show Comments" is enabled:

Firebug setting for twig debug

Automatic reloading Twig templates are compiled

Twig templates are compiled to PHP classes on disk for better performance, but this means by default your templates are not refreshed when you make changes. To enable automatic reloading of Twig templates, enable debug in services.yml. For more information, see https://drupal.org/node/1903374.

Printing variables

{{ dump() }}
{{ dump(var) }}

If you have Devel's kint submodule you can get an accordion display of the variables available to twig with:

{{ kint() }}

More debugging options can be found in the next section.

AttachmentSize
twig-debug.png77.28 KB

Looking for support? Visit the Drupal.org forums, or join #drupal-support in IRC.