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

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.

Twig documentation is licensed under the new BSD license.

`first`¶

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

{{ [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.

first¶