hugo-modules is the open-source Hugo module collection from Gethugothemes — a developer toolkit of 30+ Go-based modules that extend Hugo sites with components, shortcodes, SEO tools, icons, PWA, and performance features.
What is hugo-modules?
hugo-modules is an open-source repository published by Gethugothemes, the team behind premium Hugo themes like Bigspring, Reader, Agico, Logbook, and Copper. It is a library of 30+ Hugo modules that plug into a Hugo site's module configuration and extend it with pre-built features such as image handling, gallery sliders, site search, video embeds, accordions, tabs, modals, table of contents, gzip caching, and PWA support. Each module lives in its own directory with its own usage instructions, and the whole project is licensed under the MIT License.
Key Features
- 30+ modules in six groups — the collection is organized into Images, Gallery Slider, Search, Videos, Accordion, Tab, Modal, Table Of Contents, PWA, LLMS.txt, plus dedicated Components, SEO Tools, Shortcodes, and Icons folders.
- SEO Tools bundle — includes Site Verifications, Basic SEO, Google Tag Manager, Matomo Analytics, Plausible Analytics, Baidu Analytics, and Counter Analytics modules for search and traffic tracking.
- UI Components — Announcement, Cookie Consent, Crisp Chat, Pre Loader, Social Share, Valine Comment, OpenRemark Comments, Render Link, and Custom Script modules cover common site-interaction needs.
- Shortcodes — Button, Codepen, Mermaid, Notice, and Cloak Contact shortcodes add typed content blocks to markdown pages.
- Icons — Font Awesome Icons and Themify Icons modules bring icon sets into Hugo templates.
- PWA and performance — a Progressive Web App module and a Gzip Caching module support app-like behavior and faster delivery.
- MIT License — the modules are free to use in personal and commercial Hugo projects.
Who is it for?
- Hugo theme developers — reuse the same tested modules across multiple themes instead of reimplementing common features per theme.
- Freelancers and agencies — add search, analytics, cookie consent, and social sharing to client Hugo sites by configuring a module rather than writing code.
- Technical content sites — use the LLMS.txt module to expose site structure to AI crawlers, the Search module for on-site search, and the Mermaid shortcode for diagrams in documentation.
- Open-source contributors — the project accepts pull requests via a fork-and-PR workflow and tracks bugs through GitHub Issues.
Use cases
- Theme builders: drop the Gallery Slider or Components modules into a Hugo theme to get slider and site-component functionality without hand-writing JavaScript.
- Documentation sites: combine Table Of Contents, Mermaid, Notice, and Tab shortcodes to render structured technical content.
- Marketing and blog sites: enable Plausible, Matomo, Baidu, or Counter Analytics plus Google Tag Manager to measure traffic, and add Cookie Consent for compliance.
- Chat-enabled sites: wire the Crisp Chat module into a site to embed live-chat support without a separate widget script.
How does hugo-modules work?
Each module is a separate directory in the repository with its own page of installation and usage instructions. The modules are intended to be pulled into your project through Hugo's module system — the site's module configuration declares which module to load and how it should be applied — and Gethugothemes suggests reading each module's page before use.
Pricing
The entire collection is free to use. The repository is published under the MIT License, and the project description states the modules are available "for free" for use in your own projects.
FAQ
Is hugo-modules free?
Yes. The repository is licensed under the MIT License and the project page states the modules can be used in your own projects for free, including in commercial Hugo themes.
How many modules are included?
The repository lists more than 30 modules, grouped into Images, Gallery Slider, Search, Videos, Accordion, Tab, Modal, Table Of Contents, PWA, LLMS.txt, Components, SEO Tools, Shortcodes, and Icons.
How do I report a bug?
Gethugothemes uses GitHub Issues as the official bug tracker. Before opening a new issue, the project asks you to search existing issues to see if the problem has already been reported.
How can I contribute code?
Contributors fork the repository, make changes, and submit a pull request to the main branch. The project welcomes feedback, suggestions, and contributions from the community.
Which themes use these modules?
The project page lists Bigspring, Reader, Agico, Logbook, and Copper as Hugo themes powered by these modules, along with a 68+ Themes Bundle sold by Gethugothemes.
