mirror of https://github.com/gohugoio/hugo
41 lines
902 B
Markdown
41 lines
902 B
Markdown
---
|
|
title: Layout
|
|
description: Returns the layout for the given page as defined in front matter.
|
|
categories: []
|
|
keywords: []
|
|
action:
|
|
related:
|
|
- methods/page/Type
|
|
returnType: string
|
|
signatures: [PAGE.Layout]
|
|
---
|
|
|
|
Specify the `layout` field in front matter to target a particular template. See [details].
|
|
|
|
[details]: /templates/lookup-order/#target-a-template
|
|
|
|
{{< code-toggle file=content/contact.md >}}
|
|
title = 'Contact'
|
|
layout = 'contact'
|
|
{{< /code-toggle >}}
|
|
|
|
Hugo will render the page using contact.html.
|
|
|
|
```text
|
|
layouts/
|
|
└── _default/
|
|
├── baseof.html
|
|
├── contact.html
|
|
├── home.html
|
|
├── list.html
|
|
└── single.html
|
|
```
|
|
|
|
Although rarely used within a template, you can access the value with:
|
|
|
|
```go-html-template
|
|
{{ .Layout }}
|
|
```
|
|
|
|
The `Layout` method returns an empty string if the `layout` field in front matter is not defined.
|