HUGO-NEW-THEME(1)

💖 HUGO-NEW-THEME 💖

okay so bestie, this is a page from the Hugo Manual and it's literally all about hugo-new-theme — the glow-up command that births a brand new theme for you ✨

---

✨ SYNOPSIS ✨

hugo new theme [name] [flags]

---

🎀 DESCRIPTION 🎀

So here's the vibe: you run this and it creates a new theme with whatever name you gave it, tucked right into the ./themes directory. no cap 🫶

And it's not giving you some sad empty folder either — it generates a functional theme, like a whole working one, complete with template examples and sample content. it's giving starter-pack energy, it's giving "here's your theme bestie, go off" 👑

---

💅 OPTIONS 💅

• --format="toml" — your preferred file format, and the choices are toml, yaml or json. default is "toml" because of course it is 🍓
• -h, --help[=false] — help for theme. press it when you need the tea ☕

---

🌈 OPTIONS INHERITED FROM PARENT COMMANDS 🌈

these ones are inherited, so they're coming from the parent command — still iconic, still yours to use 💜

• --clock="" — sets the clock that Hugo uses, e.g. --clock 2021-11-06T22:30:00.00+09:00 ⭐
• --config="" — the config file (default is hugo.yaml|json|toml) 📄
• --configDir="config" — the config dir. default "config", we love a default 🎀
• -d, --destination="" — filesystem path to write files to 🗂️
• -e, --environment="" — the build environment 🌸
• --ignoreVendorPaths="" — ignores any _vendor for module paths matching the given Glob pattern 🙈
• --logLevel="" — log level, and your options are debug, info, warn or error 🔥
• --noBuildLock[=false] — don't create the .hugo_build.lock file. chaotic, but valid 💀
• --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. yes, that themes directory 🦋

---

👀 SEE ALSO 👀

• hugo-new(1) — the parent, the main character, go say hi 🫶

---

ngl bestie, if you forget every flag on this page, just remember hugo new theme [name] and the ./themes directory will handle the rest. fr fr 🤍

---

this cutie was brought to you by Hugo 0.169.0, dated Oct 2026 — go forth and theme, you absolute icon 💅💖✨