HUGO-MOD(1)

💅 HUGO-MOD(1) — the Hugo Manual, module edition 🎀

ok so you found the hugo-mod page, bestie — welcome to the part of the Hugo Manual where we manage modules ✨ (yes, the header line up top is literally HUGO-MOD(1), we're being official today 💅)

---

🌸 SYNOPSIS 🌸

hugo mod [command] [flags]

---

🦋 DESCRIPTION 🦋

so basically there's a whole bunch of little helpers here that help you manage the modules in your project's dependency graph 🫶 and lowkey they're iconic, but there's a catch:

most operations in here require a Go version installed on your system (>= Go 1.12) and the relevant VCS client (typically Git) 💀

good news though — you do not need any of that if you're only operating on modules inside /themes, or if you've vendored them via hugo mod vendor ✨ no cap, that's the chill path.

also, important vibe check: Hugo will always start out by resolving the components defined in the project configuration, provided by, in this exact order:

1. a _vendor directory (if no --ignoreVendorPaths flag provided) 🍓
2. Go Modules
3. or a folder inside the themes directory

periodt, that's the order 👑

want more? see https://gohugo.io/hugo-modules/ for more information 🌈

---

✨ OPTIONS ✨

• -h, --help[=false] — help for mod 🥺 (the classic "what does this even do" button)

---

💜 OPTIONS INHERITED FROM PARENT COMMANDS 💜

these are the ones you get for free from the parent command, no need to thank her 💅

• --clock="" — set the clock used by Hugo, e.g. --clock 2021-11-06T22:30:00.00+09:00 ⏰ (yes, you can time-travel your build, main character energy fr)
• --config="" — config file (default is hugo.yaml|json|toml) 🎀
• --configDir="config" — config dir
• -d, --destination="" — filesystem path to write files to 🦋
• -e, --environment="" — build environment
• --ignoreVendorPaths="" — ignores any _vendor for module paths matching the given Glob pattern 🙈 (careful, this changes what Hugo resolves!)
• --logLevel="" — log level (debug|info|warn|error) 🔥
• --noBuildLock[=false] — don't create .hugo_build.lock file
• --quiet[=false] — build in quiet mode 🤫
• -M, --renderToMemory[=false] — render to memory (mostly useful when running the server) 🧠
• -s, --source="" — filesystem path to read files relative from
• --themesDir="" — filesystem path to themes directory 🌸

---

👀 SEE ALSO 👀

your little module girlies, go say hi 💖

• hugo(1)
• hugo-mod-clean(1)
• hugo-mod-get(1)
• hugo-mod-graph(1)
• hugo-mod-init(1)
• hugo-mod-npm(1)
• hugo-mod-tidy(1)
• hugo-mod-vendor(1)
• hugo-mod-verify(1)

---

and that's the whole page, bestie, you ate that 🫶 mwah 💋

signing off with the receipts: this was Hugo 0.169.0, dated Oct 2026 — iconic, timeless, no notes 👑⭐