a SensioLabs Product

The flexible, fast, and secure
template engine for PHP

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

Questions & Feedback

License

Twig documentation is licensed under the new BSD license.

firstΒΆ

New in version 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.

Website powered by Symfony and Twig, deployed on
The Twig logo is © 2010-2017 SensioLabs