HUGO
News Docs Themes Community GitHub

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/
└── _default/
    ├── baseof.html
    ├── contact.html
    ├── home.html
    ├── list.html
    └── single.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.