HUGO-MOD-INIT(1)

💅 hugo-mod-init(1) — the Hugo Manual, bestie edition ✨

okay so you found the hugo-mod-init page in the Hugo Manual and you want the tea ☕ — here it is, no gatekeeping.

---

✨ NAME ✨

hugo-mod-init — initialize this project as a Hugo Module 🎀

🦋 SYNOPSIS 🦋

hugo mod init [flags] [args]

🌸 DESCRIPTION 🌸

So basically we're initializing this project as a Hugo Module. periodt. 🫶

Hugo will try to guess the module path all on its own (main character energy fr), but you can totally help it out by passing the path as an argument, like this:

hugo mod init github.com/gohugoio/testshortcodes

And ngl, the cute part: Hugo Modules supports multi-module projects, so you can legitimately initialize a Hugo Module inside a subfolder on GitHub — as one example — and it just works. iconic. 👑

💖 OPTIONS 💖

• -b, --baseURL="" — the hostname (and path) to the root, e.g. https://spf13.com/ ✨
• --cacheDir="" — filesystem path to the cache directory 🍓
• -c, --contentDir="" — filesystem path to the content directory 🌸
• -h, --help[=false] — help for init (the classic "wait what does this do again" button 🙈)
• --renderSegments=[] — named segments to render (these get configured in the segments config) 🎀
• -t, --theme=[] — themes to use (they live in /themes/THEMENAME/) 💅

🌈 OPTIONS INHERITED FROM PARENT COMMANDS 🌈

• --clock="" — set the clock Hugo uses, e.g. --clock 2021-11-06T22:30:00.00+09:00 ⏰
• --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
• --logLevel="" — log level (debug|info|warn|error) 🔍
• --noBuildLock[=false] — don't create the .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 the themes directory 💜

👑 SEE ALSO 👑

• hugo-mod(1) — go say hi to the parent command, iykyk 🫶

---

okay that's the whole page, you ate that 💅✨ — this was the Hugo Manual, Hugo 0.169.0, dated Oct 2026, and the page itself is HUGO-MOD-INIT(1). mwah, go init something iconic 🦋💖🔥