What's Changed

• tpl: Make any layout set in front matter higher priority 30b9c19 @bep #13588
• tpl: Fix it so embedded render-codeblock-goat is used even if custom render-codeblock exists c871062 @bep #13595

What's Changed

• tpl: Fix codeblock hook resolve issue d1c3944 @bep #13593
• tpl: Fix legacy section mappings 1074e01 @bep #13584
• tpl: Resolve layouts/all.html for all html output formats c19f1f2 @bep #13587
• tpl: Fix some baseof lookup issues 9221cbc @bep #13583

This fixes a regression introduced in v0.146.0 released earlier today.

• tpl: Skip dot and temp files inside /layouts 3b9f2a7 @bep #13579

The big new thing in this release is a fully refreshed template system – simpler and much better. We're working on the updated documentation for this, but see this issue for some more information. We have gone to great lengths to make this as backwards compatible as possible, but make sure you test your site before going live with this new version. This version also comes with a full dependency refresh and some useful new template funcs:

• templates.Current: Info about the current executing template and its call stack. Very useful for debugging.
• time.In: Returns the given date/time as represented in the specified IANA time zone.

Bug fixes

• tpl/tplimpl: Fix full screen option in vimeo and youtube shortcodes 6f14dbe @jmooring #13531

Improvements

• tpl: Warn and skip non-hook templates inside /layouts/_markup 383dd82 @bep #13577
• tpl: Add a partial lookup cache 208a0de @bep #13571
• tpl: Add templates.Current d4c6dd1 @bep #13571
• commands/new: Improve theme creation 24ac6a9 @jmooring #13489 #13544
• tpl/tplimpl: Update embedded pagination template 1e00842 @jmooring
• Reimplement and simplify Hugo's template system 83cfdd7 @bep #13541 #13545 #13515 #7964 #13365 #12988 #4891
• config: Use the non-global logger for deprecations when possible 812ea0b @bep
• tpl/time: Add time.In function 07cbe57 @jmooring #13548
• resources: Add option to silence dependency deprecation warnings c15ebce @jmooring #13530
• common/hreflect: Replace the map/RWMutex method cache with sync.Map 8d2379b @bep
• common/hexec: Remove github.com/cli/safeexec a6bd677 @jmooring #13516
• parser/metadecoder: Improve errors for non-map XML root values f34cdc3 @thevilledev
• identity: Use clear to clear the finder seen map 52561d5 @bep
• cache: Apply httpcache defaults for polling config d28c84a @khayyamsaleem #13471
• tpl/tplimpl: Add loading attribute to Vimeo shortcode b9add1c @jmooring #13445
• commands: Add --omitEmpty flag to gen chromastyles 93df176 @jmooring #13475
• tpl: Add trailing newline to robots.txt template eebea9e @willfaught
• commands: Skip flaky test on Windows 3f2e1c0 @bep #13465
• resources/image: Mark loong64 as FMA-using architecture 3a11d22 @hannesbraun

Dependency Updates

• build(deps): bump github.com/fsnotify/fsnotify from 1.8.0 to 1.9.0 18d2d2f @dependabot[bot]
• build(deps): bump golang.org/x/tools from 0.31.0 to 0.32.0 cd3e349 @dependabot[bot]
• build(deps): bump github.com/evanw/esbuild from 0.25.1 to 0.25.2 8cd799a @dependabot[bot]
• build(deps): bump golang.org/x/image from 0.25.0 to 0.26.0 af0602c @dependabot[bot]
• build(deps): bump github.com/pelletier/go-toml/v2 from 2.2.3 to 2.2.4 650fe6c @dependabot[bot]
• build(deps): bump github.com/alecthomas/chroma/v2 from 2.15.0 to 2.16.0 d63491b @dependabot[bot]
• build(deps): bump golang.org/x/net from 0.37.0 to 0.39.0 e6e18e9 @dependabot[bot]
• build(deps): bump github.com/bep/imagemeta from 0.10.0 to 0.11.0 43af3bc @dependabot[bot]
• deps: Upgrade github.com/gohugoio/hugo-goldmark-extensions/passthrough v0.3.0 => v0.3.1 10b5543 @jmooring
• build(deps): bump golang.org/x/tools from 0.30.0 to 0.31.0 26d986f @dependabot[bot]
• build(deps): bump github.com/getkin/kin-openapi from 0.129.0 to 0.131.0 ebc0693 @dependabot[bot]
• build(deps): bump github.com/spf13/afero from 1.11.0 to 1.14.0 7ca6bb0 @dependabot[bot]
• build(deps): bump github.com/bep/imagemeta from 0.9.0 to 0.10.0 bddd2f9 @dependabot[bot]
• build(deps): bump github.com/golang-jwt/jwt/v5 from 5.2.1 to 5.2.2 1c69135 @dependabot[bot]
• build(deps): bump github.com/evanw/esbuild from 0.24.2 to 0.25.1 17db4ed @dependabot[bot]
• build(deps): bump github.com/bep/godartsass/v2 from 2.4.0 to 2.4.1 3968f91 @dependabot[bot]
• build(deps): bump golang.org/x/net from 0.35.0 to 0.37.0 e9bd237 @dependabot[bot]
• build(deps): bump github.com/bep/godartsass/v2 from 2.3.2 to 2.4.0 f4f21f5 @dependabot[bot]
• build(deps): bump golang.org/x/image from 0.24.0 to 0.25.0 61c39ae @dependabot[bot]
• deps: Upgrade golang.org/x/mod v0.23.0 => v0.24.0 2037137 @bep #13484
• build(deps): bump github.com/bep/overlayfs from 0.9.2 to 0.10.0 d78d4cf @dependabot[bot]
• build(deps): bump github.com/bep/lazycache from 0.7.0 to 0.8.0 f9aae15 @dependabot[bot]
• build(deps): bump github.com/bep/imagemeta from 0.8.4 to 0.9.0 b068671 @dependabot[bot]
• build(deps): bump github.com/bep/simplecobra from 0.5.0 to 0.6.0 93d9c05 @dependabot[bot]

Documentation

• commands/gen: Set url in command pages to /docs/reference/commands/ a98ec3b @jmooring

The notable new feature is the new transform.PortableText function that makes it possible to use the Sanity CMS with Hugo.

Bug fixes

• all: Typo fixes 4094a1e @coliff
• all: Run modernize -fix ./... 521911a @bep
• readme: Fix relative links in Editions section ab9e545 @martey
• Fix some related content issues with content adapters 381c0da @bep #13443
• Fix potential nilpointer in httpcache config 227e429 @bep
• Fix --printPathWarnings when site calls templates.Defer c3d435a @bep #13420

Improvements

• Use the page path and not the backing filename as the last resort in the default sort c498d0f @bep
• tpl: HTTPS the instagram Shortcode JS 2f4e666 @coliff
• Add transform.PortableText 04f21b4 @bep
• hugolib: Deprecate _build front matter key in favor of build d0ce942 @jmooring

Dependency Updates

• deps: Upgrade github.com/rogpeppe/go-internal v1.13.1 => v1.14.1 6927e6f @bep #13449
• build(deps): bump github.com/yuin/goldmark-emoji from 1.0.4 to 1.0.5 b7ae24b @dependabot[bot]
• build(deps): bump github.com/google/go-cmp from 0.6.0 to 0.7.0 1a4851f @dependabot[bot]
• build(deps): bump github.com/tetratelabs/wazero from 1.8.2 to 1.9.0 d1f2330 @dependabot[bot]

Documentation

• github: Build docker image with both extended and withdeploy tags e5eecbd @margau

Build Setup

• snap: Update Node.js to 22.x 4fd7f32 @jmooring

What's Changed

• Fix --printPathWarnings when site calls templates.Defer c3d435a @bep #13420

What's Changed

• markup/goldmark: Fix panic on empty Markdown header 494e88a @bep #13416

Go 1.24 upgrade, several performance improvements, new :contentbasename and :slugorcontentbasename permalink tokens, enable KaTeX mhchem extension for transform.ToMath, full dependency refresh, new drop option for js.Build, new auth module option useful for private module repositories, autoID support for definition terms, new configurationTypes configuration option, and more. For more details, see this topic.

Note

• Fix auto generated header ids so they don't contain e.g. hyperlink destinations (note) 24cc255 @bep #13405 #13410

Bug fixes

• markup/goldmark: Fix panic on stray attribute nodes 85c1727 @bep
• Fix Position for passthrough hooks 641403f @bep #13406
• config: Fix server.redirects.fromRe being ignored unless server.redirects.from is also set c1f4228 @p-weston
• Fix shortcode name in error message on self-closing shortcodes with no .Inner e865d59 @bep #13344

Improvements

• config/allconfig: Deprecate :filename and :slugorfilename tokens 5de3913 @jmooring
• resources/page: Revise the new contentbasename permalinks tokens 7b7a0f3 @bep #11722
• resources/page: Add :contentbasename and :contentbasenameorslug permalink tokens cb7a433 @hacdias #11722
• Add autoID for definition terms 157d370 @bep #13403 #11566
• internal/warpc: Enable KaTeX mhchem extension 503dcf6 @jmooring
• modules: Add GOAUTH to module config 2c77719 @bep #13385
• Support menus as maps in content adapters fd38aee @bep #13384
• js/esbuild: Add drop option d25f7ec @bep #13362
• config: Remove unused code 34dcac5 @jmooring
• commands: Use punctuation consistently in short description ee43860 @jmooring
• Upgrade to Go 1.24 fd8b0fb @bep #13381
• Deprecate kind, lang, and path from front matter 9b5f786 @bep #12484
• commands: Move the CHMOD event filter up e6feb9e @bep #13373
• parser: Handle org-mode filetags as slice f02da7f @theSuess
• Add ContentTypes to config c2fb221 @bep #12274
• commands: Validate style argument passed to gen chromastyles a352e69 @jmooring #13357
• Update CONTRIBUTING.md 1dd27be @bep
• Move "print unused templates" after renderDeferred eb7a5aa @bep #13355
• Add some more server options/improvements 029d1e0 @bep

Dependency Updates

• build(deps): bump github.com/spf13/cobra from 1.8.1 to 1.9.1 a2ca956 @dependabot[bot]
• build(deps): bump github.com/sanity-io/litter from 1.5.7 to 1.5.8 367fe52 @dependabot[bot]
• build(deps): bump github.com/sanity-io/litter from 1.5.5 to 1.5.7 9c2f8ec @dependabot[bot]
• build(deps): bump github.com/gohugoio/hugo-goldmark-extensions/extras bd77944 @dependabot[bot]
• build(deps): bump golang.org/x/tools from 0.29.0 to 0.30.0 2e835d0 @dependabot[bot]
• build(deps): bump github.com/aws/aws-sdk-go-v2/service/cloudfront d89b9d8 @dependabot[bot]
• build(deps): bump google.golang.org/api from 0.206.0 to 0.221.0 8721a35 @dependabot[bot]
• build(deps): bump github.com/bep/imagemeta from 0.8.3 to 0.8.4 c054e18 @dependabot[bot]
• build(deps): bump golang.org/x/image from 0.22.0 to 0.24.0 5e4ffa0 @dependabot[bot]
• build(deps): bump golang.org/x/mod from 0.22.0 to 0.23.0 0cdcc2b @dependabot[bot]
• build(deps): bump github.com/gohugoio/hashstructure from 0.3.0 to 0.5.0 a591c44 @dependabot[bot]
• build(deps): bump github.com/bep/simplecobra from 0.4.0 to 0.5.0 2d86a05 @dependabot[bot]
• build(deps): bump github.com/aws/aws-sdk-go-v2/service/cloudfront 22ee091 @dependabot[bot]
• build(deps): bump github.com/aws/aws-sdk-go-v2 from 1.32.4 to 1.36.1 b50ab04 @dependabot[bot]
• build(deps): bump github.com/getkin/kin-openapi from 0.123.0 to 0.129.0 b772f0e @dependabot[bot]
• build(deps): bump github.com/spf13/pflag from 1.0.5 to 1.0.6 d58c019 @dependabot[bot]

Documentation

• Update README.md 5dd0ba0 @jmooring
• helpers: Add Chroma styles to docs.yaml f0c1852 @jmooring #13360

What's Changed

• Fix RSS with baseURL with sub dir when render hooks is enabled 760c13a @bep #13332
• mage: Simplify magefile 3bd73d2 @alexandear
• common/hugo: Adjust deprecation timing and message 7104de8 @jmooring #13333
• Re-introduce the LRU-evicted identities in change set calculation 835579b @bep

This is mostly a bug fix release, ironing out some quirks with the partial server rebuilds etc., but notable is also the new responseHeaders option on resources.GetRemote that allows you to extract headers from the server’s response.

Bug fixes

• Fix some server/watch rebuild issues db28695 @bep #13316
• Fix "concurrent map iteration and map write" in pages from data 329b234 @bep #13254
• Fix TailwindCSS related server rebuild issue 6c68142 @bep #13316
• Fix some server rebuild issues for non-HTML custom output formats cd7dc7a @bep #13014
• Fix cascade with overlapping sections bb7b3d3 @bep #12465
• markup/goldmark: Fix typo in func comment f704d75 @chalin

Improvements

• Don't re-render aliases on server rebuilds 778f0d9 @bep
• tpl/tplimpl: Remove leading whitespaces produced by Youtube shortcode 13b208e @alex-shpak
• resources: Remove debug statement 33b46d8 @jmooring #13320
• markup/goldmark: Trim space from blockquote render hook text e08d9af @jmooring #13302
• parser/pageparser: Don't allow parameters after closing tag in shortcodes c939c33 @guilhas07
• tpl/tplimpl: Improve shortcode test coverage 873a5cd @jmooring
• tpl/tplimpl: Deprecate gist shortcode f42a4b6 @jmooring #13211
• resources: Remove conditional used for debugging a563783 @bep
• resources: Add responseHeaders option to resources.GetRemote 68586c8 @bep #12521
• tpl/tplimpl: Skip TestTemplateFuncsExamples on s390x 51bb2fe @bep #13204
• Make cascade front matter order deterministic 7f0f50b @bep #12594
• tpl/tplimpl: Deprecate comment shortcode 77a8e34 @jmooring