Introduction
A brief introduction to Hugo Modules.
Hugo uses modules as its fundamental organizational units. A module can be a full Hugo project or a smaller, reusable piece providing one or more of Hugo’s seven component types: static files, content, layouts, data, assets, internationalization (i18n) resources, and archetypes.
Modules are combinable in any arrangement, and external directories (including those from non-Hugo projects) can be mounted, effectively creating a single, unified file system.
Some example projects:
- https://github.com/bep/docuapi
- A theme that has been ported to Hugo Modules while testing this feature. It is a good example of a non-Hugo-project mounted into Hugo’s directory structure. It even shows a JS Bundler implementation in regular Go templates.
- https://github.com/bep/my-modular-site
- A simple site used for testing.
Last updated:
March 5, 2025
:
content: Consolidate configuration documentation (b6cae5cbc)
Improve this page