Hugo on OINK

Hugo 0.158.0-0.164.x upgrade guide

Tue, 28 Jul 2026 00:00:00 +0000

This post is a companion to the Docsy 0.16.0 release post, which specifies the Hugo versions that 0.16.0 requires and validates.

Upgrade summary

This guide is for you if you’re:
- Upgrading to Docsy 0.16.0
- Upgrading only Hugo
Review BREAKING changes:
- Node 22+ is required for Hugo-managed Node tools
- HTML content and symlink security changed
Review deprecations:
- Language config and template APIs
- Imaging config and template APIs
Optionally skim:
Jump to Upgrade to Hugo 0.164.0 once you’re ready.

Language API deprecations (0.158.0)

Hugo 0.158.0 renamed several language configuration keys and template methods. The old names log deprecation notices first, then move toward warnings and eventual errors on Hugo’s deprecation timeline.

Hugo 0.152.0-0.155.x upgrade guide

Mon, 09 Feb 2026 00:00:00 +0000

This post summarizes the breaking and notable changes in Hugo 0.152.0 to 0.155.3. It is a companion post to the Docsy 0.14.0 and 0.13.0 release and upgrade guides.

Upgrade summary

This guide highlights breaking changes in Hugo 0.152.0–0.155.x and the actions you may need to take.

Review BREAKING changes:
- YAML yes/no tokens are strings
- Build order changes for multidimensional sites
Review deprecations (non-breaking, but recommended):
- lang mount option deprecated
- includeFiles/excludeFiles deprecated
Optionally skim:
- Known issues and fixes
- Notable changes
Jump to Upgrade to Hugo 0.155.x once you’re ready

YAML yes/no tokens are strings (0.152.0)

Release 0.152.0 (2025-10-21) upgrades to a more modern YAML library, which introduces a breaking change to the way that YAML interprets certain tokens across configuration files and page front matter.