How to choose a Hugo blog theme
Use a copy of the example site. Add two articles, one draft and one public, then build using the declared Hugo version. Inspect the archive, feed, image paths and a renamed article. Theme configuration is part of the adoption cost even when no application server is needed.
- Install the theme: README, Hugo configuration and module settings. The required Hugo version, extended build requirement and installation method are documented.
- Create an article: Content directories, front matter and archetypes. You can add a post with images, tags and a draft state using the documented fields.
- Publish more than one language: Language configuration and translated content. The theme supports the actual navigation and content relationships you need.
Check the theme against your publishing workflow
| Task | Where to look | Evidence to collect |
|---|---|---|
| Install the theme | README, Hugo configuration and module settings | The required Hugo version, extended build requirement and installation method are documented. |
| Create an article | Content directories, front matter and archetypes | You can add a post with images, tags and a draft state using the documented fields. |
| Publish more than one language | Language configuration and translated content | The theme supports the actual navigation and content relationships you need. |
| Keep URLs stable | Permalinks, aliases and base URL | An article rename or hosting move has a checked link and redirect plan. |
Run a small adoption trial
Use a copy of the example site. Add two articles, one draft and one public, then build using the declared Hugo version. Inspect the archive, feed, image paths and a renamed article. Theme configuration is part of the adoption cost even when no application server is needed.
Keep a note of the repository commit, environment, steps and result. Use three outcomes: demonstrated, not included, or unresolved. Estimate the work needed to close each gap before choosing. A missing check is not a pass, and this guide does not report that we performed these tests on every catalog entry.
Primary documentation
How catalog records and evidence are prepared →These are selection criteria, not claims that every listed template has these capabilities. Verify the linked repository and demo before adopting a project.
Prepared with AI assistance as a selection checklist. No named human review or hands-on project test is recorded for this guide.
Report a correction