discourse.gohugo.io Open in urlscan Pro
2602:fd3f:0:ff06::cb  Public Scan

Form analysis
1 forms found in the DOM

POST /login

<form id="hidden-login-form" method="post" action="/login" style="display: none;">
  <input name="username" type="text" id="signin_username">
  <input name="password" type="password" id="signin_password">
  <input name="redirect" type="hidden">
  <input type="submit" id="signin-button" value="Log In">
</form>

Text Content

Skip to main content



HUGO

 * Docs
 * Themes
 * GitHub

Sign UpLog In
 * 
 * 



Please read and follow the below guidelines before asking for help in the forum.

> DOCS | THEMES | NEWS | GITHUB | FAQ | RELEASE NOTES


HOW TO REQUEST HELP

Welcome to the Hugo forums and thanks for using Hugo! The below are a few
friendly tips on getting help from the other Hugo volunteers in this forum.


SOME KNOWLEDGE REQUIRED

Dare we say that while Hugo is indeed pretty magical, it is not meant to be a
“magic wand” to suddenly give you a published website a la Square Space or
Wordpress. You are expected to already know how to assemble a static web page,
for which you do need some basic knowledge of html, css, command line and text
editors. Or how to prepare a space to host your website. The bottom line is, if
you are unwilling to invest the time required to learn these things, then Hugo
is not for you.

If you do put the time in, Hugo will help you rapidly merge your html templates,
css, javascript, media, and even data, into a flexible working site. In
addition, you get the added benefit of understanding how things fit together,
which in turn makes understanding a variety of website builders and content
management systems much easier. It is really a worthwhile investment to put the
time in, to learn the basic building blocks well.

There are too many such sites to mention but if you’re just starting out, here
are a couple of sites to take a look at: w3schools, HTML5 Boilerplate or
hackr.io. Take a look at the Recommended Reading wiki post in the forum, as
well.


OK, GOT IT, HOW DO I GET HELP?

Thanks for bearing with me on the above, which needed to be said given the sheer
volume of people asking similar questions. Here are several points that if you
follow, will help get you a positive outcome in the forums:


SEARCH FIRST

Search the forum , because it is likely that your question has been asked and
answered already. Do your homework.

N.B. We discourage reviving old topics because people who participated in those
discussions of yesteryear are usually not here anymore and they rarely reply to
questions. It is best to open a new topic rather than bumping an old one.


READ THE DOCS

Read the docs, because they are pretty good and a lot of work goes into them.
Then read them again. But note that they sometimes lag behind releases a bit. If
you can help with that, please do.

A corollary to this is, read the release notes. If you are having a problem
after upgrading Hugo, you may find a hint here.


FREQUENTLY ASKED QUESTIONS

Notes to address repeat inquiries about common problems:

 * If your posts are not showing up, check if draft is set to true in your
   content frontmatter.
 * Run hugo server for the development server for inspecting your site during
   development, and just hugo to generate the /public folder in your project,
   which you upload to your site container.
 * In your config, make sure baseURL is correct.
 * If you are using a theme, you can override the theme’s files to make a
   change. For instance, assuming you are using Hyde, installed at /themes/hyde
   in your project, you can copy /themes/hyde/layouts/index.html to
   /layouts/index.html and edit that. Your copy will override that of the theme.
 * Hugo’s lookup order is a source of confusion at first, but it is well defined
   and will help you understand what template is being applied to a given page.
 * Hugo commands are case-sensitive, so pay attention to that when you build
   your templates.


GENERAL THREAD MECHANICS

Create a new thread in support, for each new issue. Generally speaking, let us
know:

 1. what you were doing or what you tried,
 2. what you expected, and
 3. what actually happened.

Format your forum posts using the de facto standard markdown, BBCode or HTML.
See Sharing code in the forums - #5 by kaushalmodi for some good tips on code
formatting.

When you do get an answer, mark the best answer in the thread using the checkbox
icon from the comment action menu (with like, edit, bookmark etc). This marks
the thread as solved. Please do not add words like SOLVED to the title.

Finally, please close the loop, by posting a summary in your thread about how
you were able to solve the problem. In fact, keeping communications public,
clear and complete helps the project.


LET US SEE YOUR CODE

Include a link to the source code repository of your project, because we really
need the context of seeing your templates and partials to be able to help you.
It is trivial to do a quick git clone on your repo, then run hugo server in your
project, to help you out. On the other hand, recreating your code from
screenshots, or sort of guessing at it, is not.

If you can’t share your repository for whatever reason, consider creating a
dummy repo that you can share, which reproduces the problem you’re experiencing.

Git repository hosting services include Github, Bitbucket, Codebase, Gitlab,
Sourcehut, and others. If you select Github, even if you do not know git or have
a repository, you can use Github “gists” for pasting logs and files. You can
include multiple files in a single gist, like this one.


ARE YOU USING A THEME?

Consider contacting the theme’s author, if it is a theme-specific question
because often the author will know better than the random passer-by in the
forum. Check the theme’s README. But at least include a link to the theme, to
help a person trying to help you.


INCLUDE ENVIRONMENT DETAILS

Include the output of hugo env from the command line:

$ hugo env

hugo v0.114.1-e9b716ad9869b79e7c374bbdae4daf5ee6406bd4+extended linux/amd64 BuildDate=2023-06-23T11:02:58Z VendorInfo=gohugoio
GOOS="linux"
GOARCH="amd64"
GOVERSION="go1.20.1"
github.com/sass/libsass="3.6.5"
github.com/webmproject/libwebp="v1.2.4"
github.com/sass/dart-sass/protocol="2.1.0"
github.com/sass/dart-sass/compiler="1.63.6"
github.com/sass/dart-sass/implementation="1.63.6"



SIMPLE CODE OF CONDUCT

Finally, this is a positive and friendly community, and as with other open
source projects, the Hugo project runs on unpaid volunteer work. Please be
reminded of a couple of rules to make things easier in the forum:

 * Pitch in!, and offer what help you can, as there is never enough time to do
   everything. If you noticed that something is lacking in the docs, you’re
   probably right, so please contribute!
 * Assume good intentions. English is the language of the forum except for a
   couple subforums, but, it is not every user’s native language. Try to avoid
   too much slang, abbreviations, or idiomatic expressions.
 * Keep it civil, courteous and polite. No personal or ad hominem attacks.
 * Don’t waste people’s time.
 * Discussion should be on topic, related to hugo usage. No off-topic topics
   like general JavaScript or CSS, or politics, please.
 * Consider this forum as the official support forum, not Stack Overflow or
   Reddit.

We haven’t had to do it very often, but, we reserve the right to ban or suspend
from this community anyone who cannot play by the rules. Thanks for your
understanding and cooperation.

 1. all categories
    
 2. all tags
    
    
    

 * Latest
 * Top
 * Categories



Topic Replies Views Activity

Help keep this forum practical
Meta
This is a reminder about how users can do their part and help keep this forum as
a useful resource about Hugo. Users really need to stop bumping old topics from
many years ago. Instead it is recommended that they open … read more 2 39.4k Mar
2021

Keep Hugo Emails out of your spam folder
Meta
Make sure to add discuss@gohugo.io to your contacts so that emails from the site
don't go into your spam folder. 7 17.4k Sep 2019

Template code can’t iterate the filetree as before
support
1 15 43m

Hugo v0.123 - Image resources being converted to lowercase
support
v0-123-x
2 36 1h

Don’t name a folder “sitemap”
support
v0-123-x
8 39 1h

Hugo v0.123 seems to anchorize terms in their URLs rather than urlize them
support
v0-123-x
6 36 2h

Anchor-only markdown links get prepended with index page path in 0.123.x
support
v0-123-x
5 68 2h

The menu generated by `sectionPagesMenu` is not detecting Children items and
does not seem to be Recursive in nature
support
menu
9 66 2h

Archetypes/about.md isn’t being applied to `hugo new about.md`
support
14 57 3h

Hugo v0.123 - Image invalid if it shares name of directory
support
v0-123-x
2 95 7h

Need help with mounts
support
2 78 7h

Nested taxonomies
support
5 45 9h

Hugo attempting to build pages on multilingual site for languages with no
content
support
v0-123-x
5 62 9h

Looking for a Front End Solution
support
11 162 11h

Upgrade from 0.122 to 0.123
support
v0-123-x
2 63 12h

Hugo can’t find icon defined in config/_default/params.yaml
support
3 56 13h

Use shortcodes to define columns and rows
support
13 80 13h

Suggestion to improve log file output of warnidf function to get cleaner logs
support
3 43 16h

Hugo 0.123.6 Released
Announcements
5 137 17h

How to make hugo watch for changes to scripts in assets directory
support
5 236 21h

Hugo 0.123.5 Released
Announcements
2 84 1d

Getting panic runtime error after upgrade to 0.123.4
support
v0-123-x
7 93 1d

0.123 doesn’t have drafts?
support
v0-123-x
5 123 1d

Unable to load text file from global resource
support
v0-123-x
18 243 1d

GitHub Pages: errors parsing go.mod: invalid go version
support
8 123 1d

lang.FormatNumber
support
i18n
1 49 1d

Dependabot Bumps: do I need to take action?
support
off-topic
1 63 1d

Why does .Title exist?
support
1 59 1d

Trying to access item in JSON from Bluesky
support
8 79 1d

Hugo v0.123.4: change detected, but changed images are not refreshed

0 52 1d







Invalid date Invalid date