Upgrade to Docsy 0.12.0 from 0.11.0

Tue, 11 Nov 2025 00:00:00 +0000

Since we didn’t publish a release announcement for 0.12.0, I’m using this opportunity to walk through the upgrade process from 0.11.0 to 0.12.0.

TL;DR: The main breaking changes in Docsy 0.12.0 stem from Hugo’s new template system, which causes layouts subfolder and filename changes.

In this post you’ll walk through the upgrade process for:

Docsy: 0.11.0 → 0.12.0
Hugo: 0.136.2 → 0.147.5 ¹
Node: LTS 20 → LTS 22 ¹

Note

This post covers the common upgrade steps you’re likely to encounter. Your project may include customizations that require additional adjustments. We recommend making these changes in a separate branch and testing thoroughly before deploying to production.

Upgrade on Docsy

Upgrade to Docsy 0.12.0 from 0.11.0