first

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

Warning Twig version 1.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.

`first`

1.12.2

The first filter was added in Twig 1.12.2.

The first filter returns the first "element" of a sequence, a mapping, or a string:

        1
2
3
4
5
6
7
8
        {{ [1, 2, 3, 4]|first }}
{# outputs 1 #}

{{ { a: 1, b: 2, c: 3, d: 4 }|first }}
{# outputs 1 #}

{{ '1234'|first }}
{# outputs 1 #}
    

Note

It also works with objects implementing the Traversable interface.