Products · Product
Hugo
Raised as a usability problem by 97 people on Hacker News over 12 years (2015–2026), in 65 threads.
No issue was raised by at least 3 people in 3 threads this year.
- 1
- 2
Every issue, all time, most people first
Documentation too unhelpful for building a template manuallyUnreviewed
20152026- Documentation was too unhelpful for building a Hugo template manually2026-08-24
- Hugo's docs are so confusing the commenter gave up and switched back2025-08-31
- Documentation is impenetrable, making it hard to learn and use Hugo2024-10-13
Publishing requires terminal, git and CI stepsUnreviewed
20152026- Publishing via git and markdown has worse UX than dedicated blogging platforms like Substack2026-01-03
- Publishing requires terminal, git and CI steps, too much like developer work2021-09-11
- Using git on a phone to publish posts is painful2020-01-07
Unreviewed issues were grouped by machine: Claude Haiku labelled each comment as a usability complaint, named what it's about and summed up the problem in a line, and a small model grouped similar problems. Nobody has checked them by hand. Expect mistakes.
The newest 50 complaints
- Documentation was too unhelpful for building a Hugo template manually2026-08-24
- Templating was utterly confusing to the commenter2026-01-16
- Commenter had to keep looking up syntax in the docs; templating was rough to figure out2026-01-04
- Publishing via git and markdown has worse UX than dedicated blogging platforms like Substack2026-01-03
- Problems are not surfaced where they occur, making troubleshooting tedious2025-08-31
- Hugo's docs are so confusing the commenter gave up and switched back2025-08-31
- Learning curve is sharp, making it hard to get started2025-03-05
- Breaking changes between versions force the user to guess and downgrade until the site builds2024-10-14
- Found the static site generator too complicated for a simple blog2024-10-13
- Documentation is impenetrable, making it hard to learn and use Hugo2024-10-13
- Getting image links and internal references right takes many iterations of trial and error2024-10-13
- Documentation is hard to understand, so it is difficult to use2024-10-13
- Hugo felt unintuitive, with weird syntax and logic for the commenter2024-10-13
- Hard to locate the CSS needed to change site colors2024-08-20
- Hugo conventions are esoteric and its documentation is hard to parse at a glance2024-07-20
- Writing content is annoying: images linked by filename, clunky markdown editing, no embeds2024-07-01
- Users must grep around the code to understand how headers and footers work2024-03-29
- Felt too complicated, with many unwanted features2023-12-31
- Templating becomes confusing and convoluted, hard to find where things belong2023-12-11
- Adding images to posts is a hassle, with no drag-and-drop upload2023-10-23
- Partials and shortcodes use different syntax, so one can't be used where the other is needed2023-08-27
- Hard to wrap head around plethora of features and concepts; unclear if docs cover needs2023-08-27
- Hard to figure out how to use, causing the user to quit2023-08-13
- Switching themes is hard, and the author gave up out of frustration2023-06-30
- Commenter couldn't figure out how to do the simplest things and gave up2023-02-28
- Go template syntax is arcane and unintuitive, so the author keeps forgetting conditionals2023-02-28
- Project folder organization is confusing to the user2023-02-27
- Unclear which variables exist, where they come from, and what types they are2023-02-27
- Docs assume prior knowledge; setting up a theme takes hours of trial and error2023-02-27
- Docs jump quickly from simple setup to needing to read the whole book2023-02-26
- Steep learning curve; docs don't explain theme design2022-09-29
- Too much friction going from idea to publishing; every small edit requires a full redeploy2022-08-29
- Has to revisit the docs every time after not using the tool for a while2022-08-09
- Pasting images requires fussing over markdown editor settings; not very accessible2022-07-17
- Docs are utterly confusing, leaving the user stuck for hours2022-03-03
- Hard to find how to do tasks; concepts are interdependent and hard to grasp2022-03-02
- Template syntax and available variables are undocumented, forcing users into Go docs2022-03-02
- Finds the documentation hard to use2022-03-02
- Hard to find how to force Let's Encrypt certificate refresh2022-03-02
- Docs don't explain scoping, partial variables, or for-loops; users must search elsewhere2022-03-02
- Documentation is hard to understand and use for learning the tool2022-03-02
- Documentation is confusing because of the tool's extreme flexibility and steep learning curve2022-03-02
- Documentation and implementation were confusing, leading to a hard-to-modify data structure2022-03-02
- Docs assume prior knowledge, jargon unexplained, newcomers must hop between tabs2022-03-02
- Can't find clear docs on how content folders map to collections2022-03-02
- Non-developers must write HTML and CSS to add analytics or footers2022-02-19
- Setup is too complicated for non-technical users to manage2022-02-19
- Themes are poorly documented, incompatible, and mix code with content2022-01-31
- Could not work out how to build a simple multi-page site with shared templates2022-01-31
- Go template syntax is confusing; author keeps looking up simple conditionals2022-01-31