Param shortcode

Insert a parameter from front matter or your project configuration into your content using the param shortcode.

To override Hugo’s embedded param shortcode, copy the source code to a file with the same name in the layouts/_shortcodes directory.

The param shortcode renders a parameter from front matter, falling back to a site parameter of the same name. The shortcode throws an error if the parameter does not exist.

content/example.md

---
title: Example
date: 2025-01-15T23:29:46-08:00
params:
  color: red
  size: medium
---

We found a {{% param "color" %}} shirt.

Hugo renders this to:

<p>We found a red shirt.</p>

Access nested values by chaining the identifiers:

{{% param my.nested.param %}}

Last updated: June 18, 2026 : Merge commit 'c86d9f4aa8a58931f52df6516f10b67c807505fb' (be780afa7)

Improve this page