Twig

The flexible, fast, and secure
template engine for PHP

a Symfony Product
Docs Filters first
You are reading the documentation for Twig 1.x. Switch to the documentation for Twig 2.x. 3.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-2021 Symfony