hugo - hugo builds your site



hugo - hugo builds your site


hugo [flags]


hugo is the main command, used to build your Hugo site.

Hugo is a Fast and Flexible Static Site Generator built with love by spf13 and friends in Go.

Complete documentation is available at


-b, --baseURL=""

hostname (and path) to the root, e.g.

-D, --buildDrafts[=false]

include content marked as draft

-E, --buildExpired[=false]

include expired content

-F, --buildFuture[=false]

include content with publishdate in the future


filesystem path to cache directory


remove files from destination not found in static directories


set the clock used by Hugo, e.g. --clock 2021-11-06T22:30:00.00+09:00


config file (default is hugo.yaml|json|toml)


config dir

-c, --contentDir=""

filesystem path to content directory


debug output

-d, --destination=""

filesystem path to write files to


disable different kind of pages (home, RSS etc.)


add Git revision, date, author, and CODEOWNERS info to the pages

-e, --environment=""

build environment


copy all files when static is changed.


enable to run some cleanup tasks (remove unused cache files) after the build

-h, --help[=false]

help for hugo


ignores the cache directory


ignores any _vendor for module paths matching the given Glob pattern

-l, --layoutDir=""

filesystem path to layout directory


log level (debug|info|warn|error)


minify any supported output format (HTML, XML etc.)


don’t create .hugo_build.lock file


don’t sync permission mode of files


don’t sync modification time of files


panic on first WARNING log


set this to a poll interval, e.g --poll 700ms, to use a poll based approach to watch for file system changes


print missing translations


print memory usage to screen at intervals


print warnings on duplicate target paths etc.


print warnings on unused templates.


build in quiet mode


render to memory (only useful for benchmark testing)

-s, --source=""

filesystem path to read files relative from


display metrics about template executions


calculate some improvement hints when combined with --templateMetrics

-t, --theme=[]

themes to use (located in /themes/THEMENAME/)


filesystem path to themes directory


write trace to file (not useful in general)

-v, --verbose[=false]

verbose output

-w, --watch[=false]

watch filesystem for changes and recreate as needed


hugo-completion(1), hugo-config(1), hugo-convert(1), hugo-deploy(1), hugo-env(1), hugo-gen(1), hugo-import(1), hugo-list(1), hugo-mod(1), hugo-new(1), hugo-server(1), hugo-version(1)

Updated 2024-01-29 - |