https://deploy-preview-2682--docsydocs.netlify.app/tags/hugo/Recent content in Hugo on DocsyHugoenSun, 19 Jul 2026 06:33:32 -0400https://deploy-preview-2682--docsydocs.netlify.app/blog/2026/hugo-0.158.0+/Mon, 15 Jun 2026 00:00:00 +0000https://deploy-preview-2682--docsydocs.netlify.app/blog/2026/hugo-0.158.0+/<p>This post summarizes breaking, security, and notable changes in Hugo 0.158.0 to 0.164.0 that are relevant to Docsy users. It is a companion post to the Docsy <a href="https://deploy-preview-2682--docsydocs.netlify.app/blog/2026/0.16.0/">0.16.0</a> release and upgrade guide, which covers the <a href="https://deploy-preview-2682--docsydocs.netlify.app/blog/2026/0.16.0/#hugo">Hugo versions that Docsy 0.16.0 requires and validates</a>.</p> <h2 id="upgrade-summary">Upgrade summary<a class="td-heading-self-link" href="#upgrade-summary" aria-label="Heading self-link"></a></h2> <p>This guide highlights Hugo changes that may require action when upgrading a Docsy site to 0.16.0.</p> <ul> <li>Review <span class="badge text-bg-warning rounded-pill text-small">BREAKING</span> changes: <a id="breaking-changes"></a> <ul> <li><i class="fa-solid fa-triangle-exclamation fa-lg text-warning px-1"></i> <a href="https://deploy-preview-2682--docsydocs.netlify.app/blog/2026/hugo-0.158.0&#43;/#node-tools">Node 22+ is required for Hugo-managed Node tools</a></li> <li><i class="fa-solid fa-triangle-exclamation fa-lg text-warning px-1"></i> <a href="https://deploy-preview-2682--docsydocs.netlify.app/blog/2026/hugo-0.158.0&#43;/#security">HTML content and symlink security changed</a></li> </ul> </li> <li>Review <strong>deprecations</strong>: <a id="deprecations"></a> <ul> <li><a href="https://deploy-preview-2682--docsydocs.netlify.app/blog/2026/hugo-0.158.0&#43;/#language-apis">Language config and template APIs</a></li> <li><a href="https://deploy-preview-2682--docsydocs.netlify.app/blog/2026/hugo-0.158.0&#43;/#imaging">Imaging config and template APIs</a></li> </ul> </li> <li>Optionally skim: <ul> <li><a href="https://deploy-preview-2682--docsydocs.netlify.app/blog/2026/hugo-0.158.0&#43;/#amp-escaping">Markdown-link escaping</a></li> <li><a href="https://deploy-preview-2682--docsydocs.netlify.app/blog/2026/hugo-0.158.0&#43;/#image-url-churn">Image URL churn</a></li> <li><a href="https://deploy-preview-2682--docsydocs.netlify.app/blog/2026/hugo-0.158.0&#43;/#template-module-cleanup">Template and module cleanup</a></li> <li><a href="https://deploy-preview-2682--docsydocs.netlify.app/blog/2026/hugo-0.158.0&#43;/#hugo-0-164-0">Faster builds and stricter templates</a></li> <li><a href="https://deploy-preview-2682--docsydocs.netlify.app/blog/2026/hugo-0.158.0&#43;/#notable-changes">Notable changes</a></li> </ul> </li> <li><i class="fa-solid fa-rocket text-primary px-1"></i> Jump to <a href="https://deploy-preview-2682--docsydocs.netlify.app/blog/2026/hugo-0.158.0&#43;/#upgrade">Upgrade to Hugo 0.164.0</a> once you&rsquo;re ready.</li> </ul> <h2 id="language-apis">Language API deprecations (0.158.0)<a class="td-heading-self-link" href="#language-apis" aria-label="Heading self-link"></a></h2> <p>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&rsquo;s deprecation timeline.</p>https://deploy-preview-2682--docsydocs.netlify.app/blog/2026/hugo-0.152.0+/Mon, 09 Feb 2026 00:00:00 +0000https://deploy-preview-2682--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.3. It is a companion post to the Docsy <a href="https://deploy-preview-2682--docsydocs.netlify.app/blog/2026/0.14.0/">0.14.0</a> and <a href="https://deploy-preview-2682--docsydocs.netlify.app/blog/2025/0.13.0/">0.13.0</a> release and upgrade guides.</p> <h2 id="upgrade-summary">Upgrade summary<a class="td-heading-self-link" href="#upgrade-summary" aria-label="Heading self-link"></a></h2> <p>This guide highlights breaking changes in Hugo 0.152.0–0.155.x and the actions you may need to take.</p> <ul> <li>Review <span class="badge text-bg-warning rounded-pill text-small">BREAKING</span> changes: <a id="breaking-changes"></a> <ul> <li><i class="fa-solid fa-triangle-exclamation fa-lg text-warning px-1"></i> <a href="https://deploy-preview-2682--docsydocs.netlify.app/blog/2026/hugo-0.152.0&#43;/#yaml-yes-no-etc">YAML yes/no tokens are strings</a></li> <li><i class="fa-solid fa-triangle-exclamation fa-lg text-warning px-1"></i> <a href="https://deploy-preview-2682--docsydocs.netlify.app/blog/2026/hugo-0.152.0&#43;/#build-order">Build order changes for multidimensional sites</a></li> </ul> </li> <li>Review <strong>deprecations</strong> (non-breaking, but recommended): <a id="deprecations"></a> <ul> <li><a href="https://deploy-preview-2682--docsydocs.netlify.app/blog/2026/hugo-0.152.0&#43;/#lang-mount-deprecation"><code>lang</code> mount option deprecated</a></li> <li><a href="https://deploy-preview-2682--docsydocs.netlify.app/blog/2026/hugo-0.152.0&#43;/#use-files"><code>includeFiles</code>/<code>excludeFiles</code> deprecated</a></li> </ul> </li> <li>Optionally skim: <ul> <li><a href="https://deploy-preview-2682--docsydocs.netlify.app/blog/2026/hugo-0.152.0&#43;/#known-issues">Known issues and fixes</a></li> <li><a href="https://deploy-preview-2682--docsydocs.netlify.app/blog/2026/hugo-0.152.0&#43;/#notable-changes">Notable changes</a></li> </ul> </li> <li><i class="fa-solid fa-rocket text-primary px-1"></i> Jump to <a href="https://deploy-preview-2682--docsydocs.netlify.app/blog/2026/hugo-0.152.0&#43;/#upgrade">Upgrade to Hugo 0.155.x</a> once you&rsquo;re ready</li> </ul> <h2 id="yaml-yes-no-etc"><i class="fa-solid fa-triangle-exclamation fa-lg text-warning px-1"></i> YAML yes/no tokens are strings (0.152.0) <a id="0.152.0"></a><a class="td-heading-self-link" href="#yaml-yes-no-etc" aria-label="Heading self-link"></a></h2> <p>Release <a href="https://github.com/gohugoio/hugo/releases/tag/v0.152.0">0.152.0</a> (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.</p>