Skip to main content
Previous page
Next page
Edit page
Show source code
Show Markdown
Print whole chapter

Version 9.5

See the changelog of this version for a detailed list of changes.

  • 0.166.0 Minimum required Hugo version

  • Breaking Change requiring action after upgrade

  • Change Change of behavior, may require action

  • New New behavior, often introducing new options

9.5.0 (2026-11-06)

Change

  • Change Your own topbar elements now receive the parameters of their configuration as element, like the elements of the sidebar menus do. The area they are written into is available as config.

    If your element template reads a parameter like .onwidths, change it to .element.onwidths. Reading the parameters directly still works but is deprecated and will stop working with 10.0.0. Templates only reading .page don’t need to be changed.

    If your templates call one of the theme’s elements like topbar/element/editbutton.html themselves, pass its parameters as element. Parameters given next to page still work but issue a deprecation warning.

  • Change The iconposition parameter of the button shortcode is deprecated. The icon is always shown in front of the title.

    The parameter still works but issues a deprecation warning and will stop working with 10.0.0.

  • Change The math shortcode changes in preparation for 10.0.0. Each deprecated usage still works but issues a warning.

    The shortcode, codefence and partial take your formula without delimiters. Delimiters will be taken as part of your formula with 10.0.0. Remove the delimiters around your formula. If they were inline delimiters, set the new displayMode option of the shortcode or partial to false to keep your formula inline. A codefence always displays its formula as a block; for an inline formula, use the shortcode instead.

    The options of Hugo’s transform.ToMath function moved from math to math.toMath in your project configuration and front matter. Options set directly in math, like math.output, will stop working with 10.0.0.

    Give math.toMath.macros as a list of name and definition pairs. Hugo lowercases the names of a map, so a macro containing uppercase letters can’t be used by its name. A map still works but issues a warning.

  • Change The theme has updated its Mermaid dependency to 12.2.0, which changes how your graphs look. Many diagram types are drawn with Mermaid’s new neo look and laid out by ELK, and the shipped color variants now use the new redux-color and redux-dark-color Mermaid themes.

    To keep the previous appearance, set --MERMAID-theme back to default or dark in your color variant and add { "look": "classic", "layout": "dagre" } to your Mermaid initialization options.

New

  • New The image effects height and width can now be set in your project configuration or a page’s front matter, to give all images of your site or page a default size.

  • New Topbar buttons can show their title next to their icon depending on the width of the screen, using the new options titleonwidths, titleonwidthm and titleonwidthl. The theme’s buttons keep showing only their icon unless you set these options.

  • New With the updated Mermaid dependency, you can draw use case diagrams.