How to Use a Specific Layout for an Article in Hugo
Sometimes you just want to use an unique template for a post or list. In hugo there is a template lookup order in which the template files are getting loaded but you can also specify the exact template that you want. The hugo docs explain how content organization works.
Using Frontmatter Layout
Single posts for example use the
layouts/_default/single.html template by default to show a single content page. But if you want a specific template you can use frontmatter for that.
Consider the following structure:
This would render the about page under
/about using the default
Now in the frontmatter of that post you can use
layout: "about" for example. What this line tells hugo is that it should look into the
layouts/_default folder and search for a
This is an example from my about page. It uses the
layouts/_default/about.html as template.
Using Frontmatter Type
Each content file/post gets a default content type assigned. Usually this is the name of the subfolder in
content where the post lives in. So for example a
content/blog/php.md would get the type
There is a special case though. All files directly under
content are of type
page and also all index files (but not the ones with underscore) in subfolders are of type
page as well. Keep that in mind when specifying a layout.
You can also specify the content type in frontmatter. This simply tells hugo which layouts subfolder it should use to load the templates from. For example
type: "notes" would make hugo search in the
layout you can precisely define what template to use. The template path for this example is: