HUGO
News Docs Themes Community GitHub

Languages

Returns a collection of language objects for all sites, ordered by language weight.

Syntax

SITE.Languages

Returns

langs.Languages

The Languages method on a Site object returns a collection of language objects for all sites, ordered by language weight. Each language object points to its language definition in the site configuration.

To inspect the data structure:

<pre>{{ debug.Dump .Site.Languages }}</pre>

With this site configuration:

defaultContentLanguage: de
defaultContentLanguageInSubdir: false
languages:
  de:
    languageCode: de-DE
    languageDirection: ltr
    languageName: Deutsch
    title: Projekt Dokumentation
    weight: 1
  en:
    languageCode: en-US
    languageDirection: ltr
    languageName: English
    title: Project Documentation
    weight: 2
defaultContentLanguage = 'de'
defaultContentLanguageInSubdir = false
[languages]
  [languages.de]
    languageCode = 'de-DE'
    languageDirection = 'ltr'
    languageName = 'Deutsch'
    title = 'Projekt Dokumentation'
    weight = 1
  [languages.en]
    languageCode = 'en-US'
    languageDirection = 'ltr'
    languageName = 'English'
    title = 'Project Documentation'
    weight = 2
{
   "defaultContentLanguage": "de",
   "defaultContentLanguageInSubdir": false,
   "languages": {
      "de": {
         "languageCode": "de-DE",
         "languageDirection": "ltr",
         "languageName": "Deutsch",
         "title": "Projekt Dokumentation",
         "weight": 1
      },
      "en": {
         "languageCode": "en-US",
         "languageDirection": "ltr",
         "languageName": "English",
         "title": "Project Documentation",
         "weight": 2
      }
   }
}

This template:

<ul>
  {{ range .Site.Languages }}
    <li>{{ .Title }} ({{ .LanguageName }})</li>
  {{ end }}
</ul>

Is rendered to:

<ul>
  <li>Projekt Dokumentation (Deutsch)</li>
  <li>Project Documentation (English)</li>
</ul>

Last updated: April 16, 2024 : Update debug.Dump (3dcf32e25)
Improve this page