PaperMod is a fast, clean, and responsive Hugo theme designed for bloggers and content creators. It offers a modern design with a focus on readability and performance, making it an excellent choice for personal blogs, portfolios, and documentation sites.
Based on hugo-paper, with additional features and customization options.
| PaperMod at Hugo Themes | PaperMod@themes.gohugo.io |
| Minimum Hugo Version | Hugo v0.146.0+ |
| Discord Community | Join Discord to chat with the community |
| Github Discussion | Join Discussions on Github |
| Live Demo | adityatelange.github.io/hugo-PaperMod |
| Documentation | Github Wiki |
| Example Site Source | exampleSite branch |
 |
Features 💥
☄️ Fast | ☁️ Fluent | 🌙 Smooth | 📱 Responsive
- Asset pipeline – Hugo’s built-in asset generator with fingerprinting, bundling, and minification.
- Three layout modes – Regular, Home-Info, and Profile.
- Light and dark themes – Automatic switching based on browser preference, plus a manual toggle.
- Multilingual support – Includes a built-in language selector.
- Search – Client-side search powered by Fuse.js.
- SEO optimized – Open Graph, Twitter Cards, and Schema.org structured data out of the box.
- Cover images – Per-post cover images with responsive image support.
- Table of contents – Auto-generated from heading structure.
- Multiple authors – Native support for multi-author sites.
- Social icons and share buttons – Configurable social links and per-post sharing.
- Breadcrumb navigation
- Post archives and taxonomies
- Code block copy buttons – One-click copying with Chroma syntax highlighting.
- Related post suggestions
- Zero JS build dependencies – No webpack, Node.js, or other tooling required.
| Topic | Description |
|---|---|
| Installation guide | Detailed installation and update instructions |
| Features wiki page | In-depth explanations of all features |
| FAQ wiki | Common questions and configuration walkthroughs |
| Icons wiki | Documentation for social icons and share icons |
| Variables wiki | List of all available template variables |
| Overiding templates | Guide to customizing templates without forking |
| Releases | Detailed history of releases |
Performance ☄️
PaperMod consistently scores near-perfect results on Pagespeed Insights.
Support 🫶
- Star this repository to show your support.
- Share PaperMod with others who might find it useful.
- Sponsor the project on GitHub Sponsors or Ko-Fi.
Special Thanks 🌟
- Highlight.js
- Fuse.js
- Feather Icons
- Simple Icons
- All contributors and supporters
Stargazers 📈
