Layout
Returns the layout for the given page as defined in front matter.
Syntax
PAGE.Layout
Returns
string
Specify the layout
field in front matter to target a particular template. See details.
---
layout: contact
title: Contact
---
+++
layout = 'contact'
title = 'Contact'
+++
{
"layout": "contact",
"title": "Contact"
}
Hugo will render the page using contact.html.
layouts/
├── baseof.html
├── contact.html
├── home.html
├── page.html
├── section.html
├── taxonomy.html
└── term.html
Although rarely used within a template, you can access the value with:
{{ .Layout }}
The Layout
method returns an empty string if the layout
field in front matter is not defined.
Last updated:
June 15, 2025
:
content: Update to align with v0.146.0 template system (phase 1) (0015e7a9b)
Improve this page