Dimension

Returns the dimension object for the given dimension for the given site.

Syntax: SITE.Dimension DIMENSION
Returns: page.SiteDimension

The Dimension method on a Site object returns the dimension object for the given dimension.

The DIMENSION argument must be one of language, version, or role.

Example	Returns	Equivalent to
`{{ site.Dimension "language" }}`	`langs.Language`	`{{ site.Language }}`
`{{ site.Dimension "version" }}`	`version.Version`	`{{ site.Version }}`
`{{ site.Dimension "role" }}`	`roles.Role`	`{{ site.Role }}`

{{ $languageObject := site.Dimension "language" }}
{{ $languageObject.IsDefault }} → true
{{ $languageObject.Name }} → en

{{ $versionObject := site.Dimension "version" }}
{{ $versionObject.IsDefault }} → true
{{ $versionObject.Name }} → v1.0.0

{{ $roleObject := site.Dimension "role" }}
{{ $roleObject.IsDefault }} → true
{{ $roleObject.Name }} → guest

Last updated: November 8, 2026 : content: Remove categories from front matter (1cc1dd83a)

Improve this page