spaceless

You are reading the documentation for Twig 2.x. Switch to the documentation for Twig 1.x, 3.x.

Warning Twig version 2.x is no longer maintained.

Questions & Feedback

Found a typo or an error?
Want to improve this document? Edit it.

Need support or have a technical question?
Ask support on Stack Overflow.

License

Twig documentation is licensed under the new BSD license.

`spaceless`

Tip

As of Twig 2.7, use the spaceless filter instead.

Use the spaceless tag to remove whitespace between HTML tags, not whitespace within HTML tags or whitespace in plain text:

        1
2
3
4
5
6
7
        {% spaceless %}
    <div>
        <strong>foo</strong>
    </div>
{% endspaceless %}

{# output will be <div><strong>foo</strong></div> #}
    

This tag is not meant to "optimize" the size of the generated HTML content but merely to avoid extra whitespace between HTML tags to avoid browser rendering quirks under some circumstances.

Tip

If you want to optimize the size of the generated HTML content, gzip compress the output instead.

Tip

If you want to create a tag that actually removes all extra whitespace in an HTML string, be warned that this is not as easy as it seems to be (think of textarea or pre tags for instance). Using a third-party library like Tidy is probably a better idea.

Tip

For more information on whitespace control, read the dedicated section of the documentation and learn how you can also use the whitespace control modifier on your tags.