HUGO-NEW-CONTENT(1)

📦
version 0.169.0 · 10 versions
, in arch rolling

💖 hugo-new-content — it's the Hugo manual, bestie (section 1) 💖

✨ NAME ✨

hugo-new-content — create new content 🎀 like, it makes a fresh content file for you, no cap

🌸 SYNOPSIS 🌸

hugo new content [path] [flags]

🦋 DESCRIPTION 🦋

okay so picture this: you run this and it creates a new content file for you, and it automatically sets the date and the title. literally does the boring part for you. it will guess which kind of file to create based on the path you provide — iykyk 👑

you can also just tell it the kind yourself with -k KIND if you don't trust the vibes of the guessing. it's giving "I'll handle it" but also "you can handle it if you want."

if archetypes are provided in your theme or project, they will be used. those are the blueprint vibes 🧚

⚠️ real talk though: ensure you run this within the root directory of your project. like, the root. don't be out here in some random subfolder, it will not slay.

💅 OPTIONS 💅

  • -b, --baseURL="" — hostname (and path) to the root, e.g. https://spf13.com/ 🌈
  • --cacheDir="" — filesystem path to cache directory 🍓
  • -c, --contentDir="" — filesystem path to content directory
  • --editor="" — edit new content with this editor, if provided ✏️ (like, if you actually fill this in)
  • -f, --force[=false] — overwrite file if it already exists 💀 yes queen, bulldoze it
  • -h, --help[=false] — help for content 🫶
  • -k, --kind="" — content type to create 👑
  • --renderSegments=[] — named segments to render (configured in the segments config) 🎀
  • -t, --theme=[] — themes to use (located in /themes/THEMENAME/) 🌸

🌈 OPTIONS INHERITED FROM PARENT COMMANDS 🌈

these ones come from the parent command, so like, they're hand-me-downs but make it fashion 💜

  • --clock="" — set the clock used by Hugo, 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 .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 ⭐

  • hugo-new(1) — go check out the parent, it's iconic too 👑

Hugo 0.169.0 · Oct 2026 — that's the version and date bestie, and that's the whole page 🫶✨ go make some content, you're gonna eat 💅🔥

📦 where this page comes from