https://deploy-preview-2505--docsydocs.netlify.app/tags/hugo/Recent content in Hugo on DocsyHugoenMon, 02 Feb 2026 09:11:54 -0500https://deploy-preview-2505--docsydocs.netlify.app/blog/2026/hugo-0.152.0+/Mon, 02 Feb 2026 00:00:00 +0000https://deploy-preview-2505--docsydocs.netlify.app/blog/2026/hugo-0.152.0+/<p>This post summarizes the breaking and notable changes in Hugo 0.152.0 to 0.155.1. It is a companion post to the Docsy <a href="https://deploy-preview-2505--docsydocs.netlify.app/blog/2026/0.14.0/">0.14.0</a> and <a href="https://deploy-preview-2505--docsydocs.netlify.app/blog/2025/0.13.0/">0.13.0</a> release and upgrade guides.</p> <h2 id="breaking-changes-and-deprecations">Breaking changes and deprecations<a class="td-heading-self-link" href="#breaking-changes-and-deprecations" aria-label="Heading self-link"></a></h2> <h3 id="0.153.0">0.153.0<a class="td-heading-self-link" href="#0.153.0" aria-label="Heading self-link"></a></h3> <p>Release <a href="https://github.com/gohugoio/hugo/releases/tag/v0.153.0">0.153.0</a> (2025-12-19) introduces, among other things, a powerful new <a href="https://gohugo.io/about/features/#multi-dimensional-content-model">multidimensional content model</a> (over languages, versions, and roles) through the new <a href="https://gohugo.io/quick-reference/glossary/#sites-matrix">sites.matrix</a> configuration option.</p> <p>Breaking/notable changes related to multidimensional sites are summarized next.</p> <ul> <li> <p><strong>Build order</strong></p> <ul> <li><strong>Description:</strong> Hugo now builds sites based on sorted dimensions (by weight, then name) instead of starting with the default content language. This also affects <code>.Site.Sites</code> sort order.</li> <li><strong>Impact:</strong> May affect sites relying on specific build order.</li> <li><strong>Example:</strong> the <a href="https://opentelemetry.io/">opentelemetry.io</a> Docsy-based site was affected by this change in build order. One of the fixes was to fetch the default site using the <code>default</code> selector rather than index 0 over <code>.Site.Sites</code>. For details, see <a href="https://github.com/open-telemetry/opentelemetry.io/pull/8850">open-telemetry/opentelemetry.io#8850</a>.</li> </ul> </li> <li> <p><strong><code>lang</code> mount option deprecated</strong></p>