a Symfony 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.

Table of Contents

Questions & Feedback


Twig documentation is licensed under the new BSD license.


New in version 1.5: The random function was added in Twig 1.5.

New in version 1.6: String and integer handling was added in Twig 1.6.

The random function returns a random value depending on the supplied parameter type:

  • a random item from a sequence;
  • a random character from a string;
  • a random integer between 0 and the integer parameter (inclusive).
{{ random(['apple', 'orange', 'citrus']) }} {# example output: orange #}
{{ random('ABC') }}                         {# example output: C #}
{{ random() }}                              {# example output: 15386094 (works as the native PHP mt_rand function) #}
{{ random(5) }}                             {# example output: 3 #}


  • values: The values
Website powered by Symfony and Twig, deployed on
The Twig logo is © 2010-2019 Symfony