Displays photography in a responsive photo grid
HugoPortfolio
hugo-photo-theme — Hugo Portfolio Template
By TomJamesGray
A Hugo theme for showcasing photography, organizing images in a responsive photo grid and specifying image URLs via post front matter.
Explore the design
Compare the page layouts and mobile experience. Open any screenshot for a closer look.
Author preview
Author-provided previewTop of page
Preview provided in the project README.
One original preview is available. Open the full image to inspect the design.
Screenshots show visual appearance; interactive behavior may differ.
Recorded 2026-10-03View source
What stands out
A quick read of the recorded project description.
Photos specify image URLs via the imgPostUrl post front matter parameter
Provides a shortBio parameter for a brief bio below the site title
Installation involves cloning the repository into the themes directory and specifying the theme in config.toml
MIT licensed; repository last updated in 2020
Template Details
hugo-photo-theme is a Hugo theme for photography websites. Its core presentation is a photo grid, with a responsive layout for desktop and mobile devices.
To use it, clone the theme into the project's themes directory and set theme = "hugo-photo-theme" in config.toml. Photos are created as regular posts; fill in the image URL in the imgPostUrl front matter parameter to add them to the grid. The theme also provides a shortBio parameter for displaying a brief personal bio below the site title.
The repository documentation only covers installation, grid usage, and the shortBio option. It does not describe finer display capabilities such as categories, album grouping, lightboxes, or image processing, nor does it provide additional conventions for content structure or deployment. The repository was last updated in 2020 and is under the MIT license; the free scope is limited to that version of the code, and third-party assets such as sample images require separate license verification.
HugoPortfolio
Is it right for your project?
Use Cases
- Building a personal photography website that browses photos in a grid
- Replacing an existing Hugo site with a photo grid theme
- Adding and displaying photography images one by one as posts
Suitable For
- Photography enthusiasts building websites with Hugo
- Creators who need a simple photo grid display
- Developers who want to use theme code under the MIT license
Getting started & customization
Use these recorded setup notes alongside the repository instructions for your chosen version.
- 1
Clone the repository into the project's themes directory
- 2
Set theme = "hugo-photo-theme" in config.toml
- 3
Create posts and fill in imgPostUrl in the front matter to add them to the grid
- 4
Set shortBio in [params] to display a bio below the site title
- 5
Third-party assets such as sample images require separate license verification
License & source material
Usage conditions & limitations
Free to use · keep license noticeThis entry covers the free version under the MIT license in the public repository; the free scope is that version of the code and does not mean external services or third-party assets are free.
Must comply with when using
- Free use, modification, commercial use, and distribution of that version of the code are permitted.
- When distributing copies or substantial portions of the code, retain the original author's copyright notice and the full MIT license notice.
- The code is provided as is; warranties and limitations of liability are governed by the original license and applicable law.
Additional costs & items to verify
- Demo images, fonts, icons, and other third-party assets require separate license verification and cannot be judged solely by the code's MIT license.
- External services such as domains, hosting, databases, payments, or AI may incur additional charges.
View Original Text Basis
https://github.com/TomJamesGray/hugo-photo-theme/blob/master/LICENSEhttps://github.com/TomJamesGray/hugo-photo-theme/blob/master/README.mdPermission is hereby granted, free of charge
Original License Text
Compiled by DeepSeek based on repository license and README ·2026-10-03. Results only cover the materials read; dependencies, images, fonts, and subsequent term changes are subject to their respective original texts.
Project checks & description sources
Template Information
- Source platforms
- GitHub
- Documentation and maintenance reference score
- Less documented · 48 / 100
- Technologies
- Hugo
- Website type
- Portfolio
How this score is calculated
Our heuristic uses license records (up to 30), a demo link (12), a preview (10), stars (15), recorded maintenance (15), description completeness (8), feature records (5) and classification data (5). It is not a code, security or performance test, or a Google score. A link does not establish tested functionality.
What to verify for this project
- Repository update recorded
- 2020-04-12
- Screenshot last checked
- 2026-10-03
No demo link is recorded. Use the repository instructions to evaluate the project locally; the screenshot alone cannot establish interactive behavior.
The catalog identifies Hugo as the primary stack. Check the actual dependency manifest and lockfile for versions and hosting requirements. These notes use recorded metadata, not a code audit or a deployment test.
Use a selection guide →How this description was prepared
AI-assisted description based on catalog records and repository material. Repository authors are not automatically the reviewers of this description.
Automatically checked against source and license rules; no manual editorial review.
Inspect the recorded source material
SHA-256: 46345f6de9a859868dc0f9f4cd372251a39dddefa9bfe58da3583060c6fdeaaf
2026-10-03T00:15:58.015Z
Source file / repository# Photo Theme
**A simple, responsive photo grid theme for Hugo**
### Screenshots
### Installation
Firstly you need to clone this repo in the `themes` directory for your project:
```
$ cd themes
$ git clone https://github.com/TomJamesGray/hugo-photo-theme
```
Then specify `hugo-photo-theme` as your theme by adding the following line in your `config.toml` file
```
theme = "hugo-photo-theme"
```
### Grid usage
To add photos to the grid all you need to do is make a post as usual then specify the image url as the `imgPostUrl property`, for example
```
---
title: "Image Name"
date: 2020-04-02T21:44:26+01:00
draft: false
imgPostUrl: "Your URL Here"
---
```
### Options
Short bio (the text under the site title)
```
[params]
shortBio = "xyz"
```Explore similar templates
Compare previews and descriptions within the same stack and category.
hugo-PaperMod
A fast, clean, responsive Hugo theme for blogs and lightweight portfolios, with three layout modes (Regular, Home-Info, Profile), automatic and manual light/dark themes, Fuse.js client-side search, multilingual support, and built-in Open Graph, Twitter Cards, and Schema.org data.
Hugo · Portfolio
Congo
Congo is a minimal Hugo content theme built on Tailwind CSS 3.0, designed for blogs, portfolios, and lightweight content sites. It offers multiple homepage layouts, customizable dark mode, multilingual support including RTL, and built-in client-side search, Mermaid, Chart.js, and KaTeX.
Hugo · Blog
toha
Toha is a Hugo theme for personal portfolios, featuring a minimalist, responsive design with configurable homepage sections such as about, experience timeline, and achievements gallery.
Hugo · Portfolio
hugo-profile
hugo-profile is a mobile-first Hugo theme for personal portfolios and blogs, with multilingual support, light/dark themes, categories and tags, Google Analytics, Disqus comments, and Formspree contact forms.
Hugo · Portfolio
hugo-theme-introduction
Introduction is a minimal Hugo theme that can be configured as a single-page site or a full site with multiple sections. Homepage sections are generated from Markdown files under content/home/, with weight sorting and optional images.
Hugo · Portfolio
hugo-theme-console
A minimalist, responsive Hugo theme inspired by the system terminal and built on Terminal CSS. It includes blog posts, photo galleries, and custom pages, with light/dark theming and style overrides via CSS variables.
Hugo · Portfolio