Upgrade on Docsy

Release 0.14.0 report and upgrade guide

Sat, 07 Feb 2026 00:00:00 +0000

Highlights

Styles and customization: navbar improvements, reorganized SCSS files
Content and localization: new Markdown alert syntax and internationalization improvements
Hugo 0.155.0 requirement, and 0.153+ breaking and notable changes

Release summary

Styles and customization:
- Navbar improvements, including configurable light/dark theme and adjustable height
- Heading aliases and in-page targets
- Reorganized internal SCSS files
  
  ⚠️ If you customize Swagger UI, this impacts you!

Hugo 0.152.0-0.155.x upgrade guide

Wed, 04 Feb 2026 00:00:00 +0000

This post summarizes the breaking and notable changes in Hugo 0.152.0 to 0.155.2. 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.

Release 0.13.0 report and upgrade guide

Mon, 24 Nov 2025 00:00:00 +0000

Highlights

Docsy 0.13.0 includes the most upvoted enhancement request of 2025, and more.
This release has new features and only minor breaking changes.¹
Read about our experiences using AI to upgrade Docsy projects.

Release summary

Docsy 0.13.0 comes with the following notable features and fixes:

Navigation and UX improvements including the most upvoted enhancement request of 2025: Active TOC entry tracking (#349, #2289)
Alert shortcode rewrite for better Markdown support
Accessibility enhancements for better color contrast and dark mode support

Ready to upgrade?

Review BREAKING changes:
- Alert shortcode body content processing changes
- Language menu visibility changes
Optionally skim:
- New features
- Other notable changes
Jump to Upgrade to 0.13.0 once you are ready.

Active TOC entry tracking

Docsy 0.13.0 introduces active table of contents (TOC) entry tracking, the most upvoted enhancement request of 2025. This feature highlights the TOC entry corresponding to the page’s section that is currently in view. The feature is implemented using (a patched version of) Bootstrap’s ScrollSpy. The new default TOC labels “On this page” and “Top of page” are localizable. For details, see Active TOC entry tracking with ScrollSpy.

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

Release 0.14.0 report and upgrade guide

Release summary

Hugo 0.152.0-0.155.x upgrade guide

Upgrade summary

YAML yes/no tokens are strings (0.152.0)

Release 0.13.0 report and upgrade guide

Release summary

Ready to upgrade?

Navigation and UX improvements

Active TOC entry tracking

Upgrade to Docsy 0.12.0 from 0.11.0