Param shortcode

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

The param shortcode inserts the value of 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 %}}

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

Last updated: October 29, 2026 : content: Refine callout usage across the site (711fe3a35)

Improve this page