HUGO

Requesting Help

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 :mag:, because it is likely that your question has been asked and answered already. Do your homework.

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 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.

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 Output and Environment Details

First, use the --verbose switch on hugo server to produce more details on the command line including about errors.

Include the output of hugo env from the command line, and any other relevant versions.

~> hugo env
Hugo Static Site Generator v0.55.2-9D0203488/extended darwin/amd64 BuildDate: 2019-04-17T12:29:48Z
GOOS="darwin"
GOARCH="amd64"
GOVERSION="go1.12.2"
~> git version
git version 2.20.1

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.

11 Likes
Problems with my first site
As Beginner, should I create .Md or .HTML pages
About template lookup order and creating sections and lists
Cannot access Hugo website
/content/ Directory Not being display, only 404 error page
No static files after Hugo Update from 0.41 to 0.42.1
How to render a set of HTML files directly?
Taxonomy list is alwasy empty
Listing tags in posts of specific category
Custom Robots.txt and sitemap.xml Templates
Multipage Content Types?
Vim syntax highlighting for Hugo HTML templates
<delimit .Params.tags...>: error calling delimit:
Link to index.md -> index.html
Pages with _index.md not updating
error error
I need help
Canned replies plugin
[SOLVED] Reference multilingual content from template
Generate proper URLs from an array of srcset in front matter
Create pagination for specific tag inside array of tags
Problems using Algolia with Hugo: javascript and go
Developing Locally, Problem with Paths
Use different layout for a specific Term in a Taxonomy
Page not populating to public dir
Clean way to override capitilization of Site.Title (and subtile)
[Solved] Do that unless there is content in the page
Meta tags not displaying
Problem with taxonomy.html inside a custom folder
Og:site_name is not generated using template "_internal/opengraph.html"
How to keep inner text unchanged in markdown?
Vertical sections not displaying
Function “Hugo” not defined
Increase page width to display table
Can I prevent markdownify to introduce 'id' for headers?
Problems with Hugo and Prism.js
.Site.Data is just empty map[]
Resize image from static folder
Questions when running the Hugo in a Docker container
Home blank
Using .Inner shortcode to add style
Hugo 101: Processing Images
Ordering & limiting elements in menu
Hugo output error
Cactus Plus Twittercard Issue
Possible Bug: Hugo complains about duplicate menu entries in 0.55.5
CSS won't render on on watch
Static pdf files always return 404
Trouble with intersect and json data
Want to make changes to Hugo-Initio Theme
Found no layout file for "HTML"
How to get hugo to serve an HTML page from /static/
Multiple single site based on one content file with conditional parts
Help me with something in Hugo
Documentation for template syntax, structure, and variables
Hugo serve error
Using range where with front-matter values
How does defaultContentLanguageInSubDir work?
Content directories getting into site map
How to change theme for Hugo website hosted on Gitlab
Config.filetype Code Toggle won't work
Create a new page with custom layout
Best theme for Hugo beginner
Hugo page is not rendering
Hugo page is not rendering
How can I switch the language of the current page
Hugo template lookout order killing me right now
String / Variable Concatenation to build Path for partial
Using `absURL` in a SVG `<use>` element
How to change blog posts order to ascending (chronological) order
Count of posts in category taxonomy terms list
Is there a way to use larger numbers than a normal int
Problems with safeHTML
How can I redirect to an external link on click of header of any blog?
Add front matters variable to Partial
Split a post/page up into different web pages with pagination
Publications not shown
Pages and navigation build inconsistently
Blog content not showing on my blog page
Error 404 images
Cannot match the specified template
Linking to external javascript file
Hugo ignores existing content. shortlink error: No page found with path or logical name
Hugo-git v0.34.r27.g4eb2fec6-1 broke will see if v0.31.1 will handle it now
[Solved] Select files that are direct children of content, not in sub-folders
Google Search Console reports sitemap.xml as invalid
Md content markup converted to html markup
Hugo 0.56 - Content rendering randomly working
How can I make images viewable on local hugo server?
Unable to generate cloned hugo Website
Is it possible to loop through shortcode arguments?
Hugo doesn't produce output
Youtube shortcode from data file?
Github Site not rendering in Hugo Theme
Is it Possible to create a website with multiple themes
Image Processing syntax
Referencing an image path from a page bundle in SCSS
BlogDown Academic
Append to Aside
Having trouble fixing tab title text
[SOLVED] Menu ordering not working
Need better debugging support
(solved) Problem listing languages in a correct order and switching to a language-specific page URL
Images on Project view=1
Range block not rendering grouped list on homepage
Weird URL duplication problem
Gitlab Pages and Static Files
Help with error when setting up deployment pipeline - Travis-ci
Is there any flag for offline rendering?
How can I put my taxonomy items into a fixed order?
Selecting a menu item when displaying a list of items based on taxonomy
[SOLVED] Struggling to use .Resources in a leaf bundle
[SOLVED] Lastmod vs Docker Container
Problems with extra single.html for leaf bundle
Issue Updating Title or Sub-title on Hugo
`hugo serve --bind` doesn't work with multilingual?
How to iterate over headless pages?
preserveTaxonomyNames being sporadic?
Syntax higlighting works only locally
Unclear how to use lang.Merge - How to add language fallback for content
Incomplete generation of a new theme
Creating RSS feed for a section [SOLVED]
Site doesn't load as expected on Firebase
How to display recent posts in the homepage?
Custom list.html for categories page
Avatar not showing
How to subtract 2 variable?
Publishing Hugo
Reveal-hugo Theme rendering blank page
Importing trees of md files into a Hugo project?
Error while trying to build cloned site
Making static pages render
[SOLVED] Functions in shortcodes not available?
Affiliation url link in academic template is not working
[SOLVED] Header and Footer of a Blog Post are not Rendered Correctly after Translation (mulilingual mode)
Scary letters in Windows cmd
Need help with categories and tags pages
Tag "C#" page show 404
Some strange issue
[SOLVED] New Theme Not Rendering
Changing a hugo theme and PDF output
Can page resources be put into a custom order?
CSS Styles Not Working on Posts and Some Navigation Links
Rendering page resources
Bundled images, range, and context
[SOLVED] Json data generated from PowerShell could not be read from Hugo
[Quickstart] Content not displayed when site deployed
Issue when deploying with Gitlab
Manually changing date in page front matter stops page from being rendered
Anchor for headlines
Hugo themem create home page and seperatly a route to display blog post
Hugo href links not working - 404 error
Adding a logo to Hyde theme
Range breaking main page
How to add page content (custom theme)
[SOLVED] Theme not rendering on site
relURL not always outputing URL
[SOLVED] Exclude a post type from rendering, but not from the list?
Hugo site locally has no index.html in public folder yet works on Netlify
How to create dropdown menu in sidebar
Post link leads nowhere and images not showing up on site
How to create dropdown menu in sidebar
Disabling a hugo help site
Wercker S3 pipeline :error while building
Hugo 0.47 --minify fails with "parse error:3:5: unexpected ending in qualified rule, expected left brace token 3:<"
Repeated section hidden in html
Converting blog to AMP gives blank page
Filtered Pagination results in a "gap"
Pagination creates both /pages/ and /section/page/
[SOLVED] Problem on shared hosting
`hugo --minify` strips out `</p>` tags
Social Media icons from Codepen
How to implement a scrolling list in hugo academic theme for a custom widget
Custom Robots.txt and sitemap.xml Templates
How to replace the main image in Hugo AirSpace Theme
Rendering lastmod date
Not able to access files from unknown folder
Cannot get mmark include to find the file. What am I doing?
How to translate only a subset of the pages?
Handling of unknown file extensions?
How to override index.md
Embedding dj3s in posts
Embedded Getty images in Hugo
Sidebar on sub pages
Hugo gives 404 instead of static page
[SOLVED] Tag list pages work locally but are 404 in production
[SOLVED] Not able to install theme/set it in config
[SOLVED] How to setup permalinks for all pages?
Adding Pages in the Kube Theme
Link to IRC in menu doesn't work
Sorting paginated pages by date
[SOLVED] Site only displaying submodule content
Escaping Meta Tag Content? Help
[SOLVED] Relative link to markdown file from config.toml
Why generated paged's link without suffix html?
Access term metadata from within .Data.Terms.ByCount loop
Images in static folder only display locally
Created a new theme but theme cannot be found Gitlab Hosting
[SOLVED] About page not being generated for GitHub Pages
RSS Feeds for diffrent file types
Change theme in Hugo
Hugo not rendering title / date anymore
Regarding Logo path not working
Uploaded Hugo site not rendering properly
Function "resources" not defined
Where to add the function latest posts?
Add image url
"hugo server" serves content pages, but "hugo" (build) doesn't build them
How to sort on inner field?
Get URL formatted URL string
How to access home page params from any context
Can't figure out the very basics of content structure ↔︎ generated
Display size of forum guidelines
Some of my tags doesn't work
Control which pages get generated
Translation of the plural and zero in Russian returns the name of the variable
Iterate through an array of nested maps(json objects)
Adding news section with limited number of posts and without extra pages
Taxonomy terms do not render when sorted by weight
Mermaid shortcode not working
Error compiling Swiper CSS
The Icon image lost on the Gitlab Pages
Link clickable
Using .range in a single page and .md files
Merge local and data-driven content in list
Multilingual permalinks with relLangURL and custom slug
Theme mainroad: how to hide posts in the main page?
How to Emulate Linked List Behavior
Just a new by in need
Get First Page of Home
Add link to title from scratch output
Regarding Multiple inner pages with differnent-2 Layout
An "s" too .... at the end in the title of sections
[SOLVED] Baseof.html rewrite doesn't work as expected
Problems with my first site
Search Index .json-file for Lunr.js
Default language in both root and subfolders
Dynamically load datafiles based on variables
Home page showing full path
Maybe "relativeURLs = true" isn't working properly, or maybe I haven't understood it
Extracting date and slug from filename
Which variable/parameter controls for margins
Content folder automatic creates menu
Hugo frontmatter aliases do not get created for custom content types
Can I split a .Site.Menu range over multiple columns?
Prepare for multilingual site by placing all content in lang-folder?
No sidebar background in deployed Netlify production website
List all tags, categories
Some beginner questions about themes
Public folder - clarification needed
Help with Customizing beautifulhugo theme
Help with Customizing beautifulhugo theme
Use minimo's [recent_posts] widget in the menu
Theme Appearance different from local to internet
Add Matlab icon to Skill section
Posts not being listed with custom directory
JPG error after upgrading Hugo
Custom sorting - joining arrays
How to link tags list to post list
Pagination fails after listing posts
Include-file shortcode context issues
Sort a post's categories/tags alphabetically? (micro.blog)
No page variables?
Need help sorting out Error in shell cmd and Error building site
How to add pages to category pages
Collapsible menu
Prevent from unwanted line breaks in bash code blocks
ERR! Exit status 134
Please Stay On Topic
Error with template: illegal number syntax: "-"
Installed hugo. Installed template. But localhost:1313 BLANK or ERROR
[SOLVEDAfter 'hugo server' I get 404 unless I re-save a file]
Upgrading problems
Link slider to post
Detect if Amp Page
Attaching Expired Authors to Posts?
New Hugo adventures - so simple I cant understand... :)
Unable to process SCSS file in Hugo 0.58.3
Not able to run index.html file under Public folder
Adding Twitter Feed - Solved
Cannot get jQuery to work in Hugo
Multiple blogs in a single domain
CORS disallows fetching remote file
Thoughts on Academic theme linking to these support forums
The most recent draft article is being partially included in non-draft builds in 0.57.0
Stylesheed doesn't render in gitlab pages
Site Suddenly Not Building Properly
Issue with viewing /posts on Hugo site, GitHub pages
List Template with Top-Level Sub-Directories listed with pages
Please help me add an external link to my site
Please help me add an external link to my site
Not able to run index.html file under Public folder
How to Add a Featured Video?
Simple javascript library import not working
Random Or Automatically Featured Image?
Using 2 'popups' before seeing my site - cookies help needed
Updated from 0.55.6 to 0.58.3, post list broke
How to add education detail
Opimal image workflow
Different values of .Site.Language.Lang in template and in js file
Adding front matter to tags/category rollup pages
How to sort by date descending, but force pinned messages (also descending) first?
Is there a way to avoid the Twitter shortcode throwing an error if the linked tweet becomes unavailable?
It takes 4 hours to deploy my website on Netliy, but can't finish
Git pages 404 problems
Search works locally but not on domain
My loop makes a loop too much
How to resize images
为hugo添加动态推荐阅读列表
Browser showing error: unexpected token '<'
Strange /page/01/ folder in public
getJSON reports Not Found on valid URL
Theme ananke doesn't work? quick start should be revised?
How to hide root dir when get key for title in home page
Hugo-coder 404's at random
Hugo-coder 404's at random
Is this possible In Hugo?
Keeping drafts out of the rss feed
[Solved] Do that unless there is content in the page
New post not shown
Comprehensive hugo tutorial for beginners?
Business frontpage template
Nil pointer evaluating resource.Resource.RelPermalink
A conditional in single.html that selects if a single post or single page is being rendered?
Simplify template reuse
Markdown render hook image for AMP template not working
*resources.genericResource is not an image, but its png
Help with getJSON: unexpected end of JSON input
I can't get author taxonomy pages to work
Make tag words bold in content
absURL doesn't work with the variable
{{.Content}} in list.html Not Rendering Markdown Headings
Unable to use image filters
Unable to use image filters
Something changed and now my content/post are not rendered at /
Loop all pages in a folder on homepage
Highlight current menu item - config.toml
Adding animations to Hugo site
.Params not working in home.md?
Unhelpful error
Loop Problem
Using Html instead of Markdown
Hugo showing Blank page while accessing in URL
Add raw html page as post
Is it possible to get every category dynamically to display it?

Reformatted the other day for readability, and added links to release notes today.

1 Like

What is this? “OT”: I dont understand?!

1 Like

OT means Off-Topic

2 Likes

Thanks fort the change! :wink: