`plural`

.. versionadded:: 3.11

The ``plural`` filter was added in Twig 3.11.

The plural filter transforms a given noun in its singular form into its plural version:

.. code-block:: twig

{# English (en) rules are used by default #}
{{ 'animal'|plural() }}
animals

{{ 'animal'|plural('fr') }}
animaux

.. note::

The ``plural`` filter is part of the ``StringExtension`` which is not
installed by default. Install it first:

.. code-block:: bash

    $ composer require twig/string-extra

Then, on Symfony projects, install the ``twig/extra-bundle``:

.. code-block:: bash

    $ composer require twig/extra-bundle

Otherwise, add the extension explicitly on the Twig environment::

    use Twig\Extra\String\StringExtension;

    $twig = new \Twig\Environment(...);
    $twig->addExtension(new StringExtension());

Arguments

locale: The locale of the original string (limited to languages supported by the from Symfony inflector_, part of the String component)
all: Whether to return all possible plurals as an array, default is false

.. note::

Internally, Twig uses the `pluralize`_ method from the Symfony String component.

.. _inflector: https://symfony.com/doc/current/components/string.html#inflector .. _pluralize: https://symfony.com/doc/current/components/string.html#inflector