Requesting Help


Please read the following guidelines before requesting help in the forum.


How to Request Help

Welcome to the Hugo forums and thanks for using Hugo! A few friendly tips on getting help in this forum.

  • Search the forum :mag:, because it is likely that your question has been asked and answered already. Do your homework.
  • Read the docs, because they are good and a lot of work goes into them. Then read them again.
  • 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.
  • 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.
    • 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.
  • Consider getting a free Github account and using Github “gists” for pasting logs and files (or another pastebin web app), which you can use even if you do not yet understand git, or have a source code repository. You can include multiple files in a single gist.
  • Include a link to the theme you’re using. 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.
  • Format your posts using markdown, BBCode or HTML. See Sharing code in the forums for some good tips on code formatting.
  • 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, or any other relevant versions.
  • 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.
  • 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.
~> hugo env
Hugo Static Site Generator v0.47/extended darwin/amd64 BuildDate: 2018-08-17T09:27:19Z
~> git version
git version 2.18.0

Some Knowledge Required

Let me mention here that you do need some basic knowledge of html, css, command line and editors to use Hugo effectively, as it builds on top of that knowledge. There are too many sites to mention but if you’re just starting, here are a couple of sites to take a look at: w3schools, HTML5 Boilerplate or Take a look at the Recommended Reading wiki post in the forum, as well.

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:

  • Offer what help you can, as there is never enough time to do everything.
  • Assume good intentions. English is the language of the forum, but, it is not every user’s native language.
  • Keep it civil, courteous and polite. No personal or ad hominem attacks.
  • Discussion should be on topic, related to hugo usage. No OT topics like general JavaScript or CSS, or politics, please.

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.

Problems with my first site
About template lookup order and creating sections and lists
As Beginner, should I create .Md or .HTML pages
Cannot access Hugo website
Home page showing full path
/content/ Directory Not being display, only 404 error page
No static files after Hugo Update from 0.41 to 0.42.1
[SOLVED] Baseof.html rewrite doesn't work as expected
Dynamically load datafiles based on variables
Mermaid shortcode not working
Taxonomy terms do not render when sorted by weight
Adding news section with limited number of posts and without extra pages
Iterate through an array of nested maps(json objects)
Translation of the plural and zero in Russian returns the name of the variable
Control which pages get generated
Some of my tags doesn't work
Get URL formatted URL string
Display size of forum guidelines
Can't figure out the very basics of content structure ↔︎ generated
How to access home page params from any context
Add image url
Where to add the function latest posts?
Function "resources" not defined
Hugo not rendering title / date anymore
Regarding Logo path not working
Change theme in Hugo
RSS Feeds for diffrent file types
[SOLVED] About page not being generated for GitHub Pages
Created a new theme but theme cannot be found Gitlab Hosting
Images in static folder only display locally
Why generated paged's link without suffix html?
[SOLVED] Relative link to markdown file from config.toml
Escaping Meta Tag Content? Help
[SOLVED] Site only displaying submodule content
Sorting paginated pages by date
Link to IRC in menu doesn't work
Adding Pages in the Kube Theme
[SOLVED] How to setup permalinks for all pages?
[SOLVED] Not able to install theme/set it in config
[SOLVED] Tag list pages work locally but are 404 in production
Hugo gives 404 instead of static page
Sidebar on sub pages
Embedded Getty images in Hugo
Embedding dj3s in posts
How to override
Handling of unknown file extensions?
How to translate only a subset of the pages?
Cannot get mmark include to find the file. What am I doing?
Not able to access files from unknown folder
Rendering lastmod date
How to replace the main image in Hugo AirSpace Theme
Custom Robots.txt and sitemap.xml Templates
Social Media icons from Codepen
`hugo --minify` strips out `</p>` tags
[SOLVED] Problem on shared hosting
Pagination creates both /pages/ and /section/page/
Filtered Pagination results in a "gap"
Converting blog to AMP gives blank page
Repeated section hidden in html
Hugo 0.47 --minify fails with "parse error:3:5: unexpected ending in qualified rule, expected left brace token 3:<"
Wercker S3 pipeline :error while building
Disabling a hugo help site
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
Hugo site locally has no index.html in public folder yet works on Netlify
[SOLVED] Exclude a post type from rendering, but not from the list?
relURL not always outputing URL
[SOLVED] Theme not rendering on site
How to add page content (custom theme)
Range breaking main page
[SOLVED] New Theme Not Rendering
Manually changing date in page front matter stops page from being rendered
Hugo themem create home page and seperatly a route to display blog post
Anchor for headlines
Issue when deploying with Gitlab
[Quickstart] Content not displayed when site deployed
[SOLVED] Json data generated from PowerShell could not be read from Hugo
Bundled images, range, and context
CSS Styles Not Working on Posts and Some Navigation Links
Rendering page resources
Can page resources be put into a custom order?
Changing a hugo theme and PDF output
Some strange issue
Tag "C#" page show 404
Need help with categories and tags pages
Scary letters in Windows cmd
[SOLVED] Header and Footer of a Blog Post are not Rendered Correctly after Translation (mulilingual mode)
Affiliation url link in academic template is not working
[SOLVED] Functions in shortcodes not available?
Making static pages render
Error while trying to build cloned site
Importing trees of md files into a Hugo project?
<delimit .Params.tags...>: error calling delimit:
Link to -> index.html
error error
I need help
Search Index .json-file for Lunr.js
Canned replies plugin
Problems with my first site
[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
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?
Split a post/page up into different web pages with pagination
Publications not shown
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
How can I make images viewable on local hugo server?
Unable to generate cloned hugo Website
Is it possible to loop through shortcode arguments?
Github Site not rendering in Hugo Theme
Is it Possible to create a website with multiple themes
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
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?
How to implement a scrolling list in hugo academic theme for a custom widget
Hugo href links not working - 404 error
Referencing an image path from a page bundle in SCSS
Youtube shortcode from data file?
Error 404 images
Blog content not showing on my blog page
Pages and navigation build inconsistently
CSS won't render on on watch
Add raw html page as post
Loop Problem
.Params not working in
Regarding Multiple inner pages with differnent-2 Layout
Add link to title from scratch output
Get First Page of Home
Just a new by in need
Theme mainroad: how to hide posts in the main page?
Multilingual permalinks with relLangURL and custom slug
Merge local and data-driven content in list
Using .range in a single page and .md files
The Icon image lost on the Gitlab Pages
Link clickable
Error compiling Swiper CSS

Shall we specify the best way to ask for help?

Post featured image