# \#modules

**URL:** https://discourse.gohugo.io/tag/modules/7.md

[Latest](https://discourse.gohugo.io/latest.md) · [Categories](https://discourse.gohugo.io/categories.md) · [Tags](https://discourse.gohugo.io/tags.md)

---

## [Is \`go get \<module\>\` required to import Hugo modules?](https://discourse.gohugo.io/t/is-go-get-module-required-to-import-hugo-modules/57562)

<div class="topic-metadata">

**Author:** [@extralongdivision](https://discourse.gohugo.io/u/extralongdivision)\
**Replies:** 4\
**Last updated:** [September 18, 2026, 2:25pm UTC](https://discourse.gohugo.io/t/is-go-get-module-required-to-import-hugo-modules/57562 "2026-09-18T14:25:40Z")

</div>

From my interpretation of the docs, the requirements to add a Hugo submodule, in my case video-js, are: Make my project a Go module with hugo mod init github.com/user/project Add the following to my config: module: …

---

## [Hugo's modular configuration syntax and strict validation are still in conflict](https://discourse.gohugo.io/t/hugos-modular-configuration-syntax-and-strict-validation-are-still-in-conflict/57512)

<div class="topic-metadata">

**Author:** [@FeRDNYC](https://discourse.gohugo.io/u/FeRDNYC)\
**Replies:** 1\
**Last updated:** [August 29, 2026, 8:04pm UTC](https://discourse.gohugo.io/t/hugos-modular-configuration-syntax-and-strict-validation-are-still-in-conflict/57512 "2026-08-29T20:04:27Z")

</div>

I’m posting this because just yesterday, attempting to upgrade an existing Hugo project from 0.147.0 to 0.162.0, I ran head-first into the exact issue described by @kaushalmodi in \`hugo mod init ..\` fails to create go.mo…

---

## [Collect sidebar elements from modules](https://discourse.gohugo.io/t/collect-sidebar-elements-from-modules/57445)

<div class="topic-metadata">

**Author:** [@MakisH](https://discourse.gohugo.io/u/MakisH)\
**Replies:** 1\
**Last updated:** [August 6, 2026, 2:13pm UTC](https://discourse.gohugo.io/t/collect-sidebar-elements-from-modules/57445 "2026-08-06T14:13:21Z")

</div>

Assume a Hugo website that renders content from different repositories. The content is collected with Hugo modules, and each module defines a section with an \_index.md. I would like each module to define their own “sect…

---

## [New audio and podcast oriented theme and shortcode in development - Feedback Appreciated](https://discourse.gohugo.io/t/new-audio-and-podcast-oriented-theme-and-shortcode-in-development-feedback-appreciated/57280)

<div class="topic-metadata">

**Author:** [@adurrr](https://discourse.gohugo.io/u/adurrr)\
**Replies:** 0\
**Last updated:** [June 17, 2026, 9:14pm UTC](https://discourse.gohugo.io/t/new-audio-and-podcast-oriented-theme-and-shortcode-in-development-feedback-appreciated/57280 "2026-06-17T21:14:23Z")

</div>

I built Wavecast, a Hugo theme and module that adds a persistent podcast/radio audio player to any Hugo site. Drop a shortcode into a page and the audio follows you across every page via a sticky footer bar for pause, se…

---

## [New (and updated) Hugo Module registry for AlpineJS packages](https://discourse.gohugo.io/t/new-and-updated-hugo-module-registry-for-alpinejs-packages/57239)

<div class="topic-metadata">

**Author:** [@bep](https://discourse.gohugo.io/u/bep)\
**Replies:** 0\
**Last updated:** [June 5, 2026, 12:34pm UTC](https://discourse.gohugo.io/t/new-and-updated-hugo-module-registry-for-alpinejs-packages/57239 "2026-06-05T12:34:31Z")

</div>

See GitHub - gohugoio/hugo-mod-alpinejs: Hugo Modules for AlpineJS + plugins + alpine-ajax · GitHub I have created a new tool (GitHub - gohugoio/npmtohugomod: Convert NPM modules from package.json to Hugo Modules. · Git…

---

## [Deep merging for menus?](https://discourse.gohugo.io/t/deep-merging-for-menus/57162)

<div class="topic-metadata">

**Author:** [@lhenze](https://discourse.gohugo.io/u/lhenze)\
**Replies:** 5\
**Last updated:** [May 18, 2026, 7:20pm UTC](https://discourse.gohugo.io/t/deep-merging-for-menus/57162 "2026-05-18T19:20:55Z")

</div>

Hi! Should \_merge = deep work with theme modules, for menus? I have a bunch of sites which all use a theme module. There is a config/\_default dir, for the sites and the theme, and inside each, a hugo.toml and menus.t…

---

## [Hugo Module for llms.txt and llms-full.txt](https://discourse.gohugo.io/t/hugo-module-for-llms-txt-and-llms-full-txt/56990)

<div class="topic-metadata">

**Author:** [@Md\_Farhad\_Hossen](https://discourse.gohugo.io/u/Md_Farhad_Hossen)\
**Replies:** 0\
**Last updated:** [April 13, 2026, 4:04am UTC](https://discourse.gohugo.io/t/hugo-module-for-llms-txt-and-llms-full-txt/56990 "2026-04-13T04:04:28Z")

</div>

Hi everyone, With the rise of AI agents and LLMs browsing the web, providing a machine-readable version of your site’s content is becoming increasingly useful. To make this easier for the Hugo community, we’ve created a…

---

## [Module, theme, or tool to display the differences between two versions (branches) of the same Hugo site](https://discourse.gohugo.io/t/module-theme-or-tool-to-display-the-differences-between-two-versions-branches-of-the-same-hugo-site/56904)

<div class="topic-metadata">

**Author:** [@garz75](https://discourse.gohugo.io/u/garz75)\
**Replies:** 0\
**Last updated:** [March 23, 2026, 7:15pm UTC](https://discourse.gohugo.io/t/module-theme-or-tool-to-display-the-differences-between-two-versions-branches-of-the-same-hugo-site/56904 "2026-03-23T19:15:50Z")

</div>

Hi everyone, I have a question that isn’t strictly related to Hugo, but since we use it to generate our website, I wanted to start here. We currently manage our product documentation using Hugo, GitLab, and Netlify. Ou…

---

## [New module: hugo-activity-heatmap (GitHub-style activity heatmap for Hugo)](https://discourse.gohugo.io/t/new-module-hugo-activity-heatmap-github-style-activity-heatmap-for-hugo/56842)

<div class="topic-metadata">

**Author:** [@mower](https://discourse.gohugo.io/u/mower)\
**Replies:** 0\
**Last updated:** [March 10, 2026, 7:38pm UTC](https://discourse.gohugo.io/t/new-module-hugo-activity-heatmap-github-style-activity-heatmap-for-hugo/56842 "2026-03-10T19:38:32Z")

</div>

Hi everyone, I turned a GitHub style activity tracker into a reusable Hugo module: Repo: Build write-up: https://hugomelis.nl/experiments/experiment-20-open-source-contribution-github-style-activity-component/ It …

---

## [Version mismatch when specifying module version](https://discourse.gohugo.io/t/version-mismatch-when-specifying-module-version/56462)

<div class="topic-metadata">

**Author:** [@ZhenShuo2021](https://discourse.gohugo.io/u/ZhenShuo2021)\
**Replies:** 3\
**Last updated:** [December 29, 2025, 1:17pm UTC](https://discourse.gohugo.io/t/version-mismatch-when-specifying-module-version/56462 "2025-12-29T13:17:30Z")

</div>

Hey folks, hope everyone’s doing well. I was testing Hugo Modules with version pinning and noticed the version ends up different across hugo.toml, go.mod, and \_vendor. Not sure if this is expected or if I missed somethi…

---

## [Hugo GPX Module Available](https://discourse.gohugo.io/t/hugo-gpx-module-available/56336)

<div class="topic-metadata">

**Author:** [@ravelzh](https://discourse.gohugo.io/u/ravelzh)\
**Replies:** 5\
**Last updated:** [December 6, 2025, 5:58pm UTC](https://discourse.gohugo.io/t/hugo-gpx-module-available/56336 "2025-12-06T17:58:58Z")

</div>

If anyone needs a Hugo module that can display multiple GPX files on a website, I’ve published the module I built for my own site on GitHub. Repository: https://github.com/ravelzh/hugo-gpx-module Demo page: https://go-…

---

## [PurgeCSS ignores layout customizations](https://discourse.gohugo.io/t/purgecss-ignores-layout-customizations/56274)

<div class="topic-metadata">

**Author:** [@scorchio](https://discourse.gohugo.io/u/scorchio)\
**Replies:** 9\
**Last updated:** [November 23, 2025, 3:37pm UTC](https://discourse.gohugo.io/t/purgecss-ignores-layout-customizations/56274 "2025-11-23T15:37:46Z")

</div>

I’m trying to set up a Hugo site that would use the GitHub - Ice-Hazymoon/hugo-theme-luna: A simple, performance-first, SEO-friendly Hugo theme / 一个轻量，快速，SEO 友好的 Hugo 主题 theme that I’ve set up as a git module. This theme…

---

## [Created a digital garden module 🌱](https://discourse.gohugo.io/t/created-a-digital-garden-module/56204)

<div class="topic-metadata">

**Author:** [@mbbroberg](https://discourse.gohugo.io/u/mbbroberg)\
**Replies:** 0\
**Last updated:** [November 3, 2025, 2:40pm UTC](https://discourse.gohugo.io/t/created-a-digital-garden-module/56204 "2025-11-03T14:40:59Z")

</div>

I wanted to extend my blog with a straightforward digital garden where content evolves over time rather than is published and then done. I came up with some pretty fun design and worked to modularize it here: Release v1.…

---

## [Problem with .Site.GetPage and module mounts?](https://discourse.gohugo.io/t/problem-with-site-getpage-and-module-mounts/56176)

<div class="topic-metadata">

**Author:** [@John\_Hayter](https://discourse.gohugo.io/u/John_Hayter)\
**Replies:** 5\
**Last updated:** [November 3, 2025, 9:44am UTC](https://discourse.gohugo.io/t/problem-with-site-getpage-and-module-mounts/56176 "2025-11-03T09:44:10Z")

</div>

I’ve got a shortcode - xref - which does the job of ref but uses the title of the target page as the link text. It works for local pages, and for pages mounted in a module. However, when I make my site multilingual, an…

---

## [V0.152.0 - Error: command error: failed to load modules](https://discourse.gohugo.io/t/v0-152-0-error-command-error-failed-to-load-modules/56124)

<div class="topic-metadata">

**Author:** [@marshalc](https://discourse.gohugo.io/u/marshalc)\
**Replies:** 5\
**Last updated:** [October 24, 2025, 4:07pm UTC](https://discourse.gohugo.io/t/v0-152-0-error-command-error-failed-to-load-modules/56124 "2025-10-24T16:07:35Z")

</div>

Evening all, Just done the move from 0.151.0 to 0.152.0 and on my first attempt at building a site I’m in the process of adding to, I got this error: hugo -D --cleanDestinationDir --gc --templateMetrics --logLevel debu…

---

## [Need help to set up the youtube hugo module on gitlab pages](https://discourse.gohugo.io/t/need-help-to-set-up-the-youtube-hugo-module-on-gitlab-pages/56064)

<div class="topic-metadata">

**Author:** [@ksdrummer](https://discourse.gohugo.io/u/ksdrummer)\
**Replies:** 18\
**Last updated:** [October 11, 2025, 2:16pm UTC](https://discourse.gohugo.io/t/need-help-to-set-up-the-youtube-hugo-module-on-gitlab-pages/56064 "2025-10-11T14:16:43Z")

</div>

Hi ! I’m hosting my website on gitlab pages. It uses hugo 140.2. I just saw the deprecation of container registry in the docs and changed my .gitlab-ci.yaml accordingly. I needed a newer version of hugo because one of…

---

## [Adding custom.css to Hugo Modules](https://discourse.gohugo.io/t/adding-custom-css-to-hugo-modules/55989)

<div class="topic-metadata">

**Author:** [@pocofrosty](https://discourse.gohugo.io/u/pocofrosty)\
**Replies:** 1\
**Last updated:** [September 28, 2025, 8:08pm UTC](https://discourse.gohugo.io/t/adding-custom-css-to-hugo-modules/55989 "2025-09-28T20:08:19Z")

</div>

When modifying a theme imported as a Hugo Module, sometimes they come with easy-to-overwrite custom.css files (Ex: poison/assets/css/custom.css at master · lukeorth/poison). Even if they don’t, when I import as a submodu…

---

## [Split config: module.toml doesn't work, but module.yaml does](https://discourse.gohugo.io/t/split-config-module-toml-doesnt-work-but-module-yaml-does/55948)

<div class="topic-metadata">

**Author:** [@repsejnworb](https://discourse.gohugo.io/u/repsejnworb)\
**Replies:** 2\
**Last updated:** [September 22, 2025, 12:29pm UTC](https://discourse.gohugo.io/t/split-config-module-toml-doesnt-work-but-module-yaml-does/55948 "2025-09-22T12:29:14Z")

</div>

Ok so initially I was going to make a case stating that modules don’t seem to work with split config. Then for lols I tried making a module.yaml and was surprised to see it worked. I’ve made a simple example repo of my…

---

## [Hugo fails to "go get" private module](https://discourse.gohugo.io/t/hugo-fails-to-go-get-private-module/55846)

<div class="topic-metadata">

**Author:** [@Brisket5993](https://discourse.gohugo.io/u/Brisket5993)\
**Replies:** 12\
**Last updated:** [September 4, 2025, 7:57pm UTC](https://discourse.gohugo.io/t/hugo-fails-to-go-get-private-module/55846 "2025-09-04T19:57:14Z")

</div>

Hi A theme module I use is stored on my SSH-only, private Git server. When I try to build the site or use hugo mod get, I get the following error: failed to execute binary “go” with args \[mod download -modcacherw\]: go:…

---

## [Maintain go.mod in the root for github](https://discourse.gohugo.io/t/maintain-go-mod-in-the-root-for-github/55501)

<div class="topic-metadata">

**Author:** [@MrHinsh](https://discourse.gohugo.io/u/MrHinsh)\
**Replies:** 1\
**Last updated:** [August 6, 2025, 12:57am UTC](https://discourse.gohugo.io/t/maintain-go-mod-in-the-root-for-github/55501 "2025-08-06T00:57:13Z")

</div>

Im looking to have the go.mod file in the root of the repo so that Github picks it up as a dependency… However my site is in /site/ and it only seams to work if I put the go.mod in that folder. Im resorting to putting a…

---

## [Get a list of Module and the version Im using](https://discourse.gohugo.io/t/get-a-list-of-module-and-the-version-im-using/55422)

<div class="topic-metadata">

**Author:** [@MrHinsh](https://discourse.gohugo.io/u/MrHinsh)\
**Replies:** 5\
**Last updated:** [July 26, 2025, 6:42pm UTC](https://discourse.gohugo.io/t/get-a-list-of-module-and-the-version-im-using/55422 "2025-07-26T18:42:49Z")

</div>

Id like to have a list, on my site, of the modules that I am using and what version it is. Can I get this info?

---

## [Page bundles - image not found from single.html](https://discourse.gohugo.io/t/page-bundles-image-not-found-from-single-html/55196)

<div class="topic-metadata">

**Author:** [@paulprogrammer](https://discourse.gohugo.io/u/paulprogrammer)\
**Replies:** 8\
**Last updated:** [July 14, 2025, 3:46pm UTC](https://discourse.gohugo.io/t/page-bundles-image-not-found-from-single-html/55196 "2025-07-14T15:46:17Z")

</div>

I have a page bundle under content/post/post-name with an image under content/post/post-name/images/the-image.png. My single.html calls a partial to help optimize the images and create a srcset. However, when the parti…

---

## [Why is my theme module not working? Should I vendor it?](https://discourse.gohugo.io/t/why-is-my-theme-module-not-working-should-i-vendor-it/54984)

<div class="topic-metadata">

**Author:** [@Stradichenko](https://discourse.gohugo.io/u/Stradichenko)\
**Replies:** 5\
**Last updated:** [June 4, 2025, 3:23pm UTC](https://discourse.gohugo.io/t/why-is-my-theme-module-not-working-should-i-vendor-it/54984 "2025-06-04T15:23:47Z")

</div>

I want to use my own theme on my personal blog (a different repo). But when trying to import theme as a module, the site renders but only with boilerplate elements, not with custom theme… I have the following doubts: W…

---

## [What is the default path for downloading dependency modules in hugo mod?](https://discourse.gohugo.io/t/what-is-the-default-path-for-downloading-dependency-modules-in-hugo-mod/54787)

<div class="topic-metadata">

**Author:** [@marsevilspirit](https://discourse.gohugo.io/u/marsevilspirit)\
**Replies:** 2\
**Last updated:** [May 20, 2025, 12:19am UTC](https://discourse.gohugo.io/t/what-is-the-default-path-for-downloading-dependency-modules-in-hugo-mod/54787 "2025-05-20T00:19:34Z")

</div>

What is the default path for downloading dependency modules in hugo mod?

---

## [Custom Functions](https://discourse.gohugo.io/t/custom-functions/54755)

<div class="topic-metadata">

**Author:** [@SomeDudeInAZ](https://discourse.gohugo.io/u/SomeDudeInAZ)\
**Replies:** 8\
**Last updated:** [May 17, 2025, 6:39pm UTC](https://discourse.gohugo.io/t/custom-functions/54755 "2025-05-17T18:39:25Z")

</div>

Hi Folks, Newb user here. I’ve seen some hints here and there throughout the forum but never anything definative. What I’d like to do is build a custom library of routines and functions that I can use. For example I m…

---

## [Define custom output for \`home\` via module - possible?](https://discourse.gohugo.io/t/define-custom-output-for-home-via-module-possible/54637)

<div class="topic-metadata">

**Author:** [@davidsneighbour](https://discourse.gohugo.io/u/davidsneighbour)\
**Replies:** 0\
**Last updated:** [May 5, 2025, 2:02pm UTC](https://discourse.gohugo.io/t/define-custom-output-for-home-via-module-possible/54637 "2025-05-05T14:02:32Z")

</div>

All the modules I am working on or using require me to manually add my custom output to the list of outputs in my config: \[outputs\] home = \[ "HTML", "myownformat" \] Is there any way to define some form of shallow/d…

---

## [exampleSite of theme not rendering properly as a module](https://discourse.gohugo.io/t/examplesite-of-theme-not-rendering-properly-as-a-module/54618)

<div class="topic-metadata">

**Author:** [@Stradichenko](https://discourse.gohugo.io/u/Stradichenko)\
**Replies:** 10\
**Last updated:** [May 5, 2025, 7:08am UTC](https://discourse.gohugo.io/t/examplesite-of-theme-not-rendering-properly-as-a-module/54618 "2025-05-05T07:08:42Z")

</div>

I’m trying to run my theme’s exampleSite as a demosite in github page using the parent theme as a module. Nevertheless, either testing on local or when published; I’m unable to properly import the PKB-theme/assets/js/ fi…

---

## [Hugo-admonitions: A simple way to add beautiful Callouts to hugo site](https://discourse.gohugo.io/t/hugo-admonitions-a-simple-way-to-add-beautiful-callouts-to-hugo-site/52576)

<div class="topic-metadata">

**Author:** [@KKKZOZ](https://discourse.gohugo.io/u/KKKZOZ)\
**Replies:** 12\
**Last updated:** [April 25, 2025, 1:00am UTC](https://discourse.gohugo.io/t/hugo-admonitions-a-simple-way-to-add-beautiful-callouts-to-hugo-site/52576 "2025-04-25T01:00:20Z")

</div>

Hey Hugo community! :waving\_hand: I wanted to share a little project I’ve been working on - hugo-admonitions. It’s a Hugo module that helps you create beautiful admonition/callout blocks in your content using simple mar…

---

## [How to modularize go templates and reuse them](https://discourse.gohugo.io/t/how-to-modularize-go-templates-and-reuse-them/54434)

<div class="topic-metadata">

**Author:** [@ethanjose1](https://discourse.gohugo.io/u/ethanjose1)\
**Replies:** 5\
**Last updated:** [April 24, 2025, 1:35pm UTC](https://discourse.gohugo.io/t/how-to-modularize-go-templates-and-reuse-them/54434 "2025-04-24T13:35:11Z")

</div>

Hi all, I was wondering if anyone has an idea of how to basically create a parametrized, reusable content adapter using modules, so that target sites can reuse it with different input data. Below is some code to get da…

---

## [How to manage common config in Hugo using modules](https://discourse.gohugo.io/t/how-to-manage-common-config-in-hugo-using-modules/54485)

<div class="topic-metadata">

**Author:** [@sumahcaa](https://discourse.gohugo.io/u/sumahcaa)\
**Replies:** 3\
**Last updated:** [April 24, 2025, 11:18am UTC](https://discourse.gohugo.io/t/how-to-manage-common-config-in-hugo-using-modules/54485 "2025-04-24T11:18:43Z")

</div>

We have multiple Hugo sites that all use a shared theme, which we’ve created as a module. Our goal is to centralize and manage all common configuration values within this theme module, so that individual sites don’t need…

[Next page](https://discourse.gohugo.io/tag/modules/7.md?match_all_tags=true&page=1&tags%5B%5D=modules)