Theme Parameters (Front Matter)
This page lists the theme’s Front Matter parameters for per-page UI, cover images, and related options.
Table of Contents
About Front Matter
When preparing pages and posts in Hugo, you can provide metadata and per‑page options in the file’s Front Matter block. The theme’s Front Matter parameters are all nested under the neso namespace. For example, the following is a YAML Front Matter placed at the top of a Markdown file:
---
title : "A Cat’s Happy Day"
date : 2025-10-06T14:53:12+08:00
description : "This diary is written by the cat — no human interference."
# other fields omitted...
# The above are Hugo’s built‑in Front Matter fields (partial list)
params:
# The following are this theme’s Front Matter parameters (partial list)
neso:
# all nested under the `neso` namespace
author : "Mochi"
show_toc : false
cover:
# Cover image options are nested one level deeper
image : "selfie.jpg"
caption : "Cat selfie"
# other fields omitted...
---
<!-- Main article/page content goes below -->
ddddddddddd,,,,,,,,,,,,,,,,,,,,,cfvsssssssszzzzTip
The theme builds and works even if you do not use any of the
nesoparameters. Add them only when you need them.
Note
The author prefers TOML for site‑wide config and YAML for Front Matter, so examples on this page use YAML.
General settings
Write directly under neso (mind the indentation):
params:
neso:
show_toc: true # key / value
toc_expanded: true # key / value
# omitted...Header metadata
The header block displays metadata such as publish date, author(s), word count, and more.
| Key | Type | Description |
|---|---|---|
author | String String[] | Author name. For a single person, provide a string (e.g., "Ada Lovelace"); for multiple people, provide an array of strings (e.g., ["Alice", "Bob", "Carol"]). |
disable_author | Boolean | Turn off author info on this page (Note: this option can only turn the feature off. If the site‑wide setting is already off, you cannot force it on here.) |
disable_reading_time | Boolean | Turn off reading‑time estimation on this page (Note: opt‑out only; if the site‑wide setting is off, you cannot force it on.) |
disable_word_count | Boolean | Turn off word count on this page (Note: opt‑out only; if the site‑wide setting is off, you cannot force it on.) |
canonical_url | String | If the post was originally published elsewhere, put the original URL here |
canonical_link_text | String | When showing the canonical_url link, prefix it with this default text; e.g., Originally published on |
hide_metadata | Boolean | Hide the entire header block |
Footer features
The footer block shows post tags, share buttons, and Previous/Next links for further reading.
| Key | Type | Description |
|---|---|---|
show_prev_next | Boolean | Show “Previous / Next” links for further reading |
disable_share | Boolean | Turn off share buttons on this page (Note: opt‑out only; if the site‑wide setting is off, you cannot force it on here.) |
disable_content_footer | Boolean | Hide the entire footer block (Note: opt‑out only; if it is already hidden in the site‑wide settings, you cannot force it to show here.) |
Other settings
| Key | Type | Description |
|---|---|---|
disable_breadcrumbs | Boolean | Turn off the breadcrumb trail on this page (Note: opt‑out only; if the site‑wide setting is off, you cannot force it on here.) |
show_toc | Boolean | Show the Table of Contents |
toc_expanded | Boolean | Expand the Table of Contents by default |
disable_comments | Boolean | Turn off the comments block on this page (Note: opt‑out only; if the site‑wide setting is off, you cannot force it on.) |
exclude_from_search | Boolean | Exclude this page from site search results |
block_indexing | Boolean | Set this page’s <meta name="robots"> to noindex, nofollow |
Cover image
Write these settings under neso → cover (mind the indentation):
params:
neso:
show_toc: true
# other settings omitted...
cover:
image : "meow.png"
caption : "Cute meow"
alt_text : "A black cat meowing"
hidden_in_list : false
hidden_in_single : false| Key | Type | Description |
|---|---|---|
image | String | Image URL; you can write a path relative to this content file, or an absolute path (root‑relative or full URL) |
caption | String | Text shown below the cover image |
alt_text | String | Alternative text for the cover image |
hidden_in_list | Boolean | Hide the cover image on post list pages |
hidden_in_single | Boolean | Hide the cover image on the single post page |