--- title: Language description: Returns the Language object for the given site. categories: [] keywords: [] params: functions_and_methods: returnType: langs.Language signatures: [SITE.Language] --- The `Language` method on a `Site` object returns the `Language` object for the given site, derived from the language definition in your project configuration. You can also use the `Language` method on a `Page` object. See [details][]. ## Methods The examples below assume the following language definition. {{< code-toggle file=hugo >}} [languages.de] direction = 'ltr' label = 'Deutsch' locale = 'de-DE' weight = 2 {{< /code-toggle >}} ### Direction {{< new-in 0.158.0 />}} (`string`) Returns the [`direction`][] from the language definition. ```go-html-template {{ .Site.Language.Direction }} → ltr ``` ### IsDefault {{< new-in 0.153.0 />}} (`bool`) Reports whether this is the [default language](g). ```go-html-template {{ .Site.Language.IsDefault }} → true ``` ### Label {{< new-in 0.158.0 />}} (`string`) Returns the [`label`][] from the language definition. ```go-html-template {{ .Site.Language.Label }} → Deutsch ``` ### Lang {{}} Use [`Name`](#name) instead. ### LanguageCode {{}} Use [`Locale`](#locale) instead. ### LanguageDirection {{}} Use [`Direction`](#direction) instead. ### LanguageName {{}} Use [`Label`](#label) instead. ### Locale {{< new-in 0.158.0 />}} (`string`) Returns the [`locale`][] from the language definition, falling back to [`Name`](#name). ```go-html-template {{ .Site.Language.Locale }} → de-DE ``` ### Name {{< new-in 0.153.0 />}} (`string`) Returns the language tag as defined by [RFC 5646][]. This is the lowercased key from the language definition. ```go-html-template {{ .Site.Language.Name }} → de ``` ### Weight {{}} ## Example Some of the methods above are commonly used in a base template as attributes for the `html` element. ```go-html-template ``` [RFC 5646]: https://datatracker.ietf.org/doc/html/rfc5646 [`direction`]: /configuration/languages/#direction [`label`]: /configuration/languages/#label [`locale`]: /configuration/languages/#locale [details]: /methods/page/language/