Hugo & PaperMod Front Matter Parameters (Alphabetical)

aliases - Array of old paths to redirect to this page (H) .
audio - Array of audio file paths for opengraph metadata (H) .
cascade - Front matter keys passed down to descendants (H) .
cover - Cover image settings with image, alt, caption, relative, responsiveImages (P) .
date - Page publication datetime (H) .
description - Description for SEO and summaries (H) .
draft - If true, page not rendered without –buildDrafts (H) .
excludeFromRSS - Excludes this page from RSS feed (P) .
expiryDate - Content expires after this datetime (H) .
headless - If true, sets leaf bundle to headless (H) .
images - Array of image paths for opengraph/twitter cards (H) .
isCJKLanguage - If true, treats content as CJK for word count (H) .
keywords - Array of meta keywords for SEO (H) .
lastmod - Last modification datetime (H) .
layout - Specific template name to override lookup order (H) .
linkTitle - Shorter version of title for links (H) .
markup - Content format renderer (md or rst) (H) .
menu - Adds page to specified menu(s) (H) .
outputs - Array of output formats to render (H) .
params - Map of custom page parameters (H) .
publishDate - Future publication date (requires –buildFuture) (H) .
resources - Array of metadata for page resources (H) .
series - Array of series this page belongs to (H) .
ShowBreadCrumbs - Shows breadcrumb navigation on the page (P) .
ShowCodeCopyButtons - Shows copy buttons on code blocks (P) .
ShowFullTextinRSS - Includes full content in RSS feed (P) .
ShowPostNavLinks - Shows previous/next post navigation at bottom (P) .
ShowReadingTime - Shows estimated reading time (P) .
ShowShareButtons - Shows social share buttons (P) .
ShowToc - Shows table of contents (P) .
sitemap - Map of sitemap options (H) .
sites - Map for sites matrix and complements (v0.153.0+) (H) .
slug - Overrides last segment of URL path (H) .
summary - Custom summary text for teasers (H) .
title - Page title (H) .
TocOpen - If true, table of contents is expanded by default (P) .
translationKey - Arbitrary value to relate translations (H) .
type - Overrides content type derived from section (H) .
url - Complete custom URL path (H) .
weight - Controls sorting order (lower numbers first) (P) .

Example .md in a Useful Manual Writing Order

  • (H) - Hugo integrated Frontmatter
  • (P) - Papermod integrated Frontmatter
---
## ===== CORE CONTENT =====
title: "Example Post Title" # (H) Page title - the most important field
linkTitle: "Short Title" # (H) Shorter version of title for links
description: "This is an example post description" # (H) Description for SEO and summaries
summary: "This is a custom summary" # (H) Custom summary text for teasers

## ===== METADATA & TAXONOMY =====
date: 2026-08-10 # (H) Page publication datetime
lastmod: 2026-08-10 # (H) Last modification datetime
publishDate: 2026-08-10 # (H) Future publication date (requires --buildFuture)
expiryDate: 2027-01-01 # (H) Content expires after this datetime
draft: false # (H) If true, page not rendered without --buildDrafts
weight: 10 # (P) Controls sorting order (lower numbers first)
keywords: ["example", "demo", "hugo"] # (H) Array of meta keywords for SEO
series: ["Tutorial Series"] # (H) Array of series this page belongs to
type: "posts" # (H) Overrides content type derived from section
layout: "custom-layout" # (H) Specific template name to override lookup order
menu: "main" # (H) Adds page to specified menu(s)
translationKey: "unique-key" # (H) Arbitrary value to relate translations

## ===== URL & REDIRECTS =====
slug: "custom-slug" # (H) Overrides last segment of URL path
url: "/custom/url/path" # (H) Complete custom URL path
aliases: ["old-post-path"] # (H) Array of old paths to redirect to this page

## ===== DISPLAY FEATURES =====
ShowReadingTime: true # (P) Shows estimated reading time
ShowToc: true # (P) Shows table of contents
TocOpen: false # (P) If true, table of contents is expanded by default
ShowBreadCrumbs: true # (P) Shows breadcrumb navigation on the page
ShowPostNavLinks: true # (P) Shows previous/next post navigation at bottom
ShowShareButtons: true # (P) Shows social share buttons
ShowCodeCopyButtons: true # (P) Shows copy buttons on code blocks
ShowFullTextinRSS: false # (P) Includes full content in RSS feed
excludeFromRSS: false # (P) Excludes this page from RSS feed

## ===== COVER IMAGE =====
cover: # (P) Cover image settings
  image: "cover.jpg"
  alt: "Cover image description"
  caption: "Photo credit: Example"
  relative: true
  responsiveImages: true

## ===== OPENGRAPH / SOCIAL =====
images: ["featured-image.jpg"] # (H) Array of image paths for opengraph/twitter cards
audio: ["audio-file.mp3"] # (H) Array of audio file paths for opengraph metadata

## ===== RESOURCES & ATTACHMENTS =====
resources: # (H) Array of metadata for page resources
  - src: "image.jpg"
    title: "Resource Title"
    params:
      alt: "Image alt text"

## ===== ADVANCED =====
headless: false # (H) If true, sets leaf bundle to headless
isCJKLanguage: false # (H) If true, treats content as CJK for word count - Chinese, Japanese, or Korean
markup: "md" # (H) Content format renderer (md or rst)
outputs: ["html", "rss"] # (H) Array of output formats to render
cascade: # (H) Front matter keys passed down to descendants
  ShowToc: true
sitemap: # (H) Map of sitemap options
  changefreq: "monthly"
  priority: 0.8
sites: # (H) Map for sites matrix and complements (v0.153.0+)
  complements:
    versions: ["v1.*.*"]
  matrix:
    languages: ["en", "fr"]
params: # (H) Map of custom page parameters
  customField: "customValue"
---