Our take
Activeregular commits- Activity
- 35
- Community
- 71
- Issues
- 41
- Pull requests
- 43
+44 stars in the last 30 days
- More contributors than 78% of the projects we track
- Slower to close issues than 84% of the projects we track
PaperMod is an actively maintained, feature-rich Hugo theme with recent commits, though its release history is less current than its commit activity.
Good fit if
- You are building a blog or portfolio with Hugo and want the theme's built-in layouts and publishing features.
- You want multilingual support, client-side search, and SEO metadata without adding a JavaScript build toolchain.
- You value recent repository activity and a large contributor base; contributions are not measured as concentrated around one person.
Look elsewhere if
- Your site is not built with Hugo, or you need a theme designed for a different platform.
- Your adoption process requires a release within the past year; the repository has recent commits, but no release in that period.
- You need a project with a short issue-resolution history; reported issue handling has a median closure time of 78 days.
All health signals
| Last commit | 2026-10-25 (7 days ago) |
|---|---|
| Commits, last 90 days | 13 |
| Releases, last 12 months | 0 (latest v8.0, 2024-11-03) |
| Contributors | 100+ (top contributor: 67% of commits) |
| Issues closed, last 90 days | 6 (typically closed in 78 days) |
| Pull requests merged, last 90 days | 1 |
| Project age | 6 years |
Checked on 2026-11-02 with the GitHub API.
Project history
Daily GitHub snapshots since Oct 7, 2026. History covers stars and forks; health signals are not tracked historically.
Stars
14,046Forks
3,427Change since Nov 17, 2026: +2 stars·-2 forks
Overview
Hugo PaperMod is a fast, clean, responsive theme built for Hugo, the static site generator. It helps people create blogs and portfolio sites with configurable layouts and common publishing features, without adding a separate JavaScript build toolchain.
Based on the hugo-paper theme, PaperMod adds further features and customization options. It supports regular, home-info, and profile layouts, as well as multilingual sites and light or dark appearance settings. The project provides a live demo, an example site, and detailed documentation in its wiki.
Key Features
- Three homepage layout modes: regular, home-info, and profile.
- Light and dark themes, with automatic browser-preference detection and a manual toggle.
- Multilingual support with a language selector.
- Client-side search powered by Fuse.js.
- SEO metadata including Open Graph, Twitter Cards, and Schema.org structured data.
- Publishing tools including cover images, tables of contents, archives, taxonomies, and related-post suggestions.
- Social links, share buttons, breadcrumbs, and multiple-author support.
- Hugo asset processing with fingerprinting, bundling, and minification, with no JavaScript build dependencies.
Use Cases
- Hugo bloggers who want a responsive theme with search, archives, and post-level features ready to configure.
- Portfolio owners who want a profile-style homepage rather than a conventional post list.
- Multilingual publishers who need a theme with a built-in language selector.
- Hugo site maintainers who want to customize templates through documented overrides instead of maintaining a fork.
What you need
Detected in the repository
- Go 1.16 or newer (from go.mod)
- Automated checks on GitHub Actions
License in plain words
MITpermissive
- Commercial use: yes
- Modify and redistribute: yes
- You must keep: the copyright and license notice
- Share your changes: no
A summary, not legal advice: the LICENSE file is what applies.
Getting Started
Follow the installation guide to add and configure the theme. The example site source provides a working configuration; see the README for project links and feature documentation.
Alternatives
- hextra: Hextra is another Hugo theme, oriented toward documentation sites as well as blogs, while PaperMod focuses on blogs and portfolios.
| Project | Language | License | Stars | Status |
|---|---|---|---|---|
| hugo-PaperMod | HTML | MIT | 14k | Active |
| hextra | HTML | MIT | 2.4k | Active |
Considerations
The README specifies Hugo v0.158.0 or later, while repository metadata lists Go 1.16 as a runtime requirement. The project reports no tests, so teams that require an established automated test suite should account for that. It has continued commit activity, but has not published a release in over a year; its measured median issue closure time is also relatively long. Review the installation and configuration documentation to confirm the theme fits your Hugo setup.
Found this useful?
Share it with someone who would like hugo-PaperMod.