If there is a problem with a Hugo site that you are developing, here are some things you can try.
Use Ctrl+C to stop the Hugo server and then restart it.
In your web browser, do a “hard reload” or “hard refresh.” How to do this in many web browsers is in en.wikipedia.org/wiki/Wikipedia:Bypass_your_cache.
hugo server with flags such as:
--gc (“garbage collector”)
-v (equivalent to
For information about these and other flags, see Infinite Ink’s Hugo CLI page.
Check that the port number in your web browser
is correct. If you have multiple Hugo servers running, you may need to look at
This can happen when you are using multiple terminals.
View your site with a different web browser.
Explicitly specify a different port, e.g.
hugo server -D -p=51000.
Put debug code in layout files.
Delete the Hugo server cache. To find its location, run
and look for the value of
resources/ directory that
hugo generates. An example
resources/ directory is discussed
5.3 in Infinite Ink’s Hugo Tutorial: Themeless & Gitless Introduction to the Hugo Static Site Generator.
In your config file(s) and front matter, make sure that any value
that you intend to be a string is not being interpreted as a number,
and vice versa. You can force a number to be interpreted as a string by using quotes,
If you use TOML in configuration files, front matter, or data files, make sure all TOML tables are at the end. Information about this is in the Now we get crazy section of Nate Finch's Intro to TOML.
If you use
includes, changes in an included file
are not noticed by
Instead you need to stop and restart
to view Mmark-include-file changes.
If you have a problem viewing emoji, smart quotation marks (such as “), mathematical symbols (such as ℵ), or any non-ASCII character, make sure your web server’s HTTP configuration and your Hugo source and destination files are all using UTF-8 encoding. UTF-8 is the standard file encoding for the web nowadays.
For more about Hugo, see Infinite Ink’s…
🔗 Linkified Section Headings in Hugo-Generated Web Pages (Featuring Markdown and AsciiDoc Examples)
Hugo Tutorial: Themeless & Gitless Introduction to the Hugo Static Site Generator
Hugo’s Markup Languages: AsciiDoc, HTML, Markdown,
Please comment so I know I'm not alone in an infinite void.