Iterate through and output localized versions of content.


This tag allows you to loop over the content in all of its locales. Or to target the content in a specific locale. This is handy for generating things like a “View this in French” style URLs.

Iterating over locales

Loop through a piece of content in each locale. An example use case may be to create a dropdown where you select which locale you want to view it in.

{{ locales }}
  <li><a href="{{ url }}">View in {{ locale:name }}</a></li>
{{ /locales }}

Targeting a locale

Rather than looping, you can specify a locale to target it directly.

{{ locales:fr }}
    <a href="{{ url }}">View in French</a>
{{ /locales:fr }}




The ID of the content you want to localize. If left blank, the content will be taken from the context.



Sort by one of the keys in your system.yaml's locales array. (eg. name or full). If left blank, the order in the file will be maintained. Only applicable in the tag pair.


boolean true

When true, this ensures that the current site locale will be first in the list. Only applicable in the tag pair.




The locale data of the current iteration. Contains key, name, and full. You can use array format to access the nested value (eg. {{ locale:name }})

content data


Each piece of content being iterated through has access to all the variables inside. This includes things like title, content, url, etc.

Last modified on October 18, 2017