What's New

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

  • 0.141.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

Version 9

9.0.0 (2026-01-01)

Hugo

  • Hugo When the theme introduced compatibility with Hugo 0.146.7 it had to remove a performance optimization due to a limitation in Hugo. This was later fixed in Hugo 0.149.0.

    This release reintroduces the performance optimization and will cause your page build to fail with the above mentioned Hugo versions. You either need to upgrade or downgrade Hugo to an unaffected version.

Breaking

  • Breaking The children shortcode has a new layout resembling the taxonomy and term pages by setting type=group.

    Sadly, introducing usage of the shortcode in the taxonomy and term pages (see below) caused necessary breaking changes

    • the shortcode now requires enabling block attributes in your hugo.toml by setting markup.goldmark.parser.attribute.block=true
    • the call syntax for type=card now is {{< children >}} instead of {{% children %}} if goldmark.unsafe=false is configured in your hugo.toml (which is the default)

    In addition the shortcode learned some new parameter for displaying breadcrumbs and setting a heading depth.

Change

  • Change This release comes with a new way to configure your logo image and title in the menu sidebar.

    With the new system you can

    • rely on auto detection for an image
    • remove the image completely
    • override the image for each variant
    • set color, sizes and fonts for title and image
    • let the image and title lay out vertically or horizontally
    • override the complete layout with your own partial (that’s the old way and still works)

    Nevertheless, this required massive changes to the CSS and most likely your logo will require tweaking of the CSS styles after an update.

    The easiest way to fix this is to remove a overridden layouts/partials/logo.html template in your installation and rely on the new configuration.

  • Change Font Awesome was updated to version 7.1.0 which results in slightly different icons.

  • Change The search results of the search box are now colored in the same way as the search results on the dedicated search page using color styles of the content area.

  • Change The expand shortcode has changed its default text of Expand me... to Details to be in sync with Hugo’s built-in details shortcode and the details HTML element.

New

  • New The taxonomy and term pages are now internally using the children shortcode. This makes it possible for you to set parameter of the children shortcode in your taxonomy/term pages front matter to change the layout.

    By that you can - for example - display the sub pages in a card layout. See the categories taxonomy for an example.

  • New The themes dark-mode support for the openapi shortcode was changed to the built-in implementation of the used Swagger library.

Version 8

8.3.0 (2025-11-27)

Hugo 0.141.0

  • 0.141.0 This release requires a newer Hugo version.

Change

  • Change The children shortcode has changed the way it picks an image if displayed as card.

    The theme now uses the same mechanism as for picking the social media image - which is done by Hugo itself. You may have to adjust the file name of your preview image accordingly.

New

  • New The theme can now check external links for validity during build. No more stale links anymore.

    To activate it set urlExternalCheck=true in the your hugo.toml params section.

    The name of option ignoreerror was changed to urlIgnoreError in that matter. You can leave your config unchanged but will see warnings if you are using the deprecated name.

  • New The tree shortcode learned to also format output of the tree terminal command of your favorite operating system.

  • New On mobile, the page title will be displayed in the breadcrumbs area.

  • New The buttons in the topbar, for the heading anchors, copying code and the reset Mermaid zoom were visually improved.

    Additionally there is a new style inline, displaying items in the style of the code inline copy-to-clipboard buttons.

  • New The tooltips shown when copying code and links, and resetting the Mermaid zoom were revamped into toast that appear at the bottom of the page.

8.2.0 (2025-11-01)

New

  • New A boxStyle configuration is now able to get its default values from an already existing predefined or user-defined style using the style field in the same way as you use it with many shortcodes.

    Additionally there are two new styles link and action, displaying items either in the style of the topbar button or like the action buttons of the Mermaid zoom or the code block copy-to-clipboard buttons.

  • New The button shortcode learned the new parameters borderless and hint.

  • New Besides the existing variables of --MAIN-TOPBAR-BORDER-color and --MENU-TOPBAR-SEPARATOR-color, the rest of the topbar colors are now also configurable.

    Namely these are --TOPBAR-BG-color, --TOPBAR-OVERLAY-BG-color, --TOPBAR-SEPARATOR-color, --TOPBAR-TEXT-color, --TOPBAR-LINK-color and --TOPBAR-LINK-HOVER-color.

  • New With refactoring of boxStyles, buttons and the topbar, it is now possible to set colors of a button when its style is either link or action.

    This makes it possible to have differing colors between buttons and links. Coloring is now independently configurable for the topbar and the main content area with the new variables --TOPBAR-BUTTON-color, --TOPBAR-BUTTON-HOVER-color as well as --MAIN-BUTTON-color and --MAIN-BUTTON-HOVER-color.

  • New Links and buttons previously were styled based on the --SECONDARY-color. A differing color for hovering was implicitly available as --MAIN-LINK-HOVER-color. To make things easier for you, this was overhauled.

    The primary, secondary and accent colors now have available hover counterparts as --PRIMARY-HOVER-color, --SECONDARY-HOVER-color and --ACCENT-HOVER-color;

    Care was taken not to break your existing style variants, so you don’t need to change anything if you are happy with the look of your current variant.

    All additions to the variables can be experienced in the style variant generator. Have fun with it!

  • New Translation into Danish.

8.1.0 (2025-10-05)

Change

  • Change The children shortcode has learned to show its children in a nice card layout.

    This required to deprecate the containerstyle and style parameter in favor of the new type parameter. Your build will succeed as before but will give you detailed warnings how to migrate your old settings to the new for each occurrence.

    If you haven’t set containerstyle or style no changes are necessary. If you used

    • containerstyle=ul or style=li now use type=tree
    • style=h* now use type=list
    • any other containerstyle or style now use type=flat

    If you want to use the new card layout, use type=card.

  • Change The externalLinkTarget config option has changed its default from _blank to _self causing external links by default to be opened in the same tab.

    If you want to get back to the previous behavior of opening external links in a new tab, set externalLinkTarget='_blank' in your hugo.toml.

New

8.0.0 (2025-09-11)

Hugo 0.126.3

  • 0.126.3 This release requires a newer Hugo version.

Breaking

Change

  • Change The <h1> color for the page heading has changed its default value from --MAIN-TEXT-color to the more logical --MAIN-TITLES-TEXT-color.

    If you experience a change in your page title color after upgrading, just set --MAIN-TITLES-H1-TEXT-color to your previously used color.

  • Change For the children shortcode the final default value if parameter sort=auto and no ordersectionsby setting was found has changed from weight to default.

    If your weights are all correctly set you will not recognize a difference. If you have duplicate weights on a level or have not set weights at all while sorting should happen by weight, this change will lead to a deterministic order while previously it didn’t.

New

  • New The theme has updated its Mermaid dependency to 11.8.0. This adds support for radar graphs and treemaps.

Older Versions