HugoStarter

gallerydeluxe — Hugo Starter Template

By bep

gallerydeluxe is a photo gallery theme used as a Hugo Module, suitable for displaying large numbers of images on a page, with configuration options for shuffling order, reversing order, Exif information, and watermarks.

Open Source Site Download Source ZIP

Explore the design

Compare the page layouts and mobile experience. Open any screenshot for a closer look.

1 previews

Author preview

View sourceOpens in a new tab

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-02View source

What stands out

A quick read of the recorded project description.

Integrated into Hugo sites as a Hugo Module

Photo gallery theme aimed at displaying large numbers of images

Supports shuffling or reversing the order of images in the gallery

Can enable Exif data display

Can configure a watermark image and position for large images

Thumbnail generation logic can be adjusted by copying the template file

Template Details

gallerydeluxe is a Hugo module for displaying photo galleries in Hugo sites. It targets scenarios with large numbers of images; the author states in the README that it is suitable for lots of images and mentions that the theme is used for staticbattery.com.

For usage, the README recommends adding the theme to a site as a Hugo Module and points to Gallery Deluxe Starter as a quick-start template; the staticbattery.com repository is another example. If multiple galleries are needed, the README suggests switching to Galleries Deluxe.

Configuration is centralized under params.gallerydeluxe, where you can set whether to shuffle the image order (shuffle), whether to reverse the image order (reverse), whether to enable Exif data (enable_exif), and whether to add a watermark to large images (watermark.image, watermark.posx, watermark.posy). The watermark image path is relative to /assets, and the position can be left/center/right and top/center/bottom.

If you need full control over how images are generated, the README explains that you can copy layouts/partials/gallerydeluxe/create-thumbs.html into your own project and adjust it. The Credits section of the README notes the use of Dan Schlosser's Pig JS library.

HugoLauncher

Is it right for your project?

Use Cases

Building image-focused photo gallery pages in a Hugo site
Needing to display many photos and wanting to control image ordering
Wanting to overlay a watermark on large gallery images
Wanting to display photo Exif information

Suitable For

Developers who use Hugo and are familiar with Hugo Modules
Personal or portfolio sites whose main content is photo display
Projects that need a single gallery rather than a multi-gallery structure

Getting started & customization

Use these recorded setup notes alongside the repository instructions for your chosen version.

1
The README recommends introducing it as a Hugo Module; Gallery Deluxe Starter can be referenced for a quick start
2
When multiple galleries are needed, Galleries Deluxe should be used instead of this theme
3
Gallery-related options are configured under params.gallerydeluxe, including shuffle, reverse, enable_exif, and watermark
4
The watermark image path is relative to /assets, and the position is specified by posx and posy
5
If full control over image generation is needed, you can copy layouts/partials/gallerydeluxe/create-thumbs.html into your own project and modify it

Read repository instructions

License & source material

Usage conditions & limitations

Free to use · keep license notice

This entry covers the free version under the MIT license in the public repository; the free scope is the code of that version and does not mean that external services or third-party assets are free.

Must comply with when using

Free use, modification, commercial use, and distribution of this version's code are permitted.
When distributing copies or substantial portions of the code, retain the original author's copyright notice and the complete 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

This theme supports only a single gallery; if a site needs multiple galleries, the README explicitly requires switching to another project, Galleries Deluxe, so multi-gallery scenarios are not suitable for this template.
Usage depends on Hugo and its Module mechanism; it must be introduced into a Hugo site as a Hugo Module and is not a general template that can be deployed independently of Hugo.
The project uses the third-party JS library Pig (pig.js), whose copyright belongs to Dan Schlosser; the license of this third-party component is independent of the project's own MIT license, and users must confirm its license conditions themselves.
Demo images, fonts, icons, and other third-party assets must be checked against their respective licenses and cannot be judged solely by the code's MIT license.
External services such as domains, hosting, databases, payments, or AI may incur separate charges.

View Original Text Basis

Permission is hereby granted, free of charge
Original License Text

If you need _multiple_ galleries, see [Galleries Deluxe](https://github.com/bep/galleriesdeluxe).
Original README

The recommended way to add this to your site is to include it as a Hugo Module.
Original README

Credit to Dan Schlosser for the [Pig](https://github.com/schlosser/pig.js) JS library.
Original README

https://github.com/bep/gallerydeluxe/blob/main/LICENSE https://github.com/bep/gallerydeluxe/blob/main/README.md

Compiled by DeepSeek based on repository license and README ·2026-10-02. 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: Hugo Themes
Documentation and maintenance reference score: More documented · 79 / 100
Technologies: Hugo
Website type: Starter

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: 2026-09-18
Screenshot last checked: 2026-10-02

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: 68efc035ff5f11b16a9dcffd195b0c62dc1f22689c6fe98d079db6f5bc64f22b

2026-10-02T18:06:46.653Z

Source file / repository

>**Note 1:** See this [Gallery Deluxe Starter](https://github.com/bep/gallerydeluxe_starter) for a fast route to get this up and running.

>**Note 2:** If you need _multiple_ galleries, see [Galleries Deluxe](https://github.com/bep/galleriesdeluxe).

<hr/>

* [Configuration](#configuration)
* [Credits](#credits)

A Hugo Module to show a photo gallery. It's very fast/effective, especially if you have lots of images on display.

This theme is what you see on [staticbattery.com](https://staticbattery.com/) which, at the time of writing this, [scores 100](https://pagespeed.web.dev/report?url=https%3A%2F%2Fstaticbattery.com%2F&form_factor=mobile) at Google PageSpeed for both mobile and desktop.

[<img src="https://raw.githubusercontent.com/bep/gallerydeluxe/main/images/tn.jpg">](https://staticbattery.com/)

## Configuration

The recommended way to add this to your site is to include it as a Hugo Module. See [Gallery Deluxe Starter](https://github.com/bep/gallerydeluxe_starter) for a starter template. Another example is [staticbattery.com](https://github.com/bep/staticbattery.com).


### Params

```toml
[params]
    [params.gallerydeluxe]
        # Shuffle the images in the gallery to give the impression of a new gallery each time.
        shuffle = false

        # Reverse the order of the images in the gallery.
        reverse = false

         # Enable Exif data in the gallery.
         # See https://gohugo.io/content-management/image-processing/#exif-data for how to filter tags.
        enable_exif = false

          # Optional watermark file for the large images.
        [params.gallerydeluxe.watermark]
            image = "images/gopher-hero8.png" # relative to /assets
            posx  = "left"                    # one of "left", "center", "right"
            posy  = "bottom"                  # one of "top", "center", "bottom"
```

If you want full control over how your images gets created, create and adjust a copy of [layouts/partials/gallerydeluxe/create-thumbs.html](layouts/partials/gallerydeluxe/create-thumbs.html) into your own project.


## Credits

Credit to Dan Schlosser for the [Pig](https://github.com/schlosser/pig.js) JS library.

Report a correction

Explore similar templates

Compare previews and descriptions within the same stack and category.

hugo-xmin

hugo-xmin is an extremely minimal Hugo theme written by Yihui Xie for template beginners. HTML and CSS total about 140 lines, with no external dependencies, and it uses the MIT license.

Hugo · Starter

hugo-theme-gallery

A Hugo Extended photo gallery theme that organizes images with Page Bundles, automatically generating album lists and gallery pages with a Justified layout and PhotoSwipe lightbox.

Hugo · Starter

reveal-hugo

reveal-hugo is a Hugo theme that converts Markdown content into Reveal.js-based HTML presentations. It supports slide separation with `---`, shortcodes for fragments, slides, sections, notes, Markdown, and MathJax, and organizes content as root or section presentations with order controlled by weight.

Hugo · Starter

anatole

Anatole is a minimalistic two-column Hugo theme ported from farbox-theme-Anatole, featuring dark mode, multilingual and RTL support, and optional portfolio, comments, analytics, KaTeX, and Mermaid integrations. It suits personal blogs, portfolios, or documentation sites built with Hugo.

Hugo · Starter

hugo-theme-diary

A Hugo diary-style theme ported from the Hexo theme Journal, with a grid homepage for essays and daily notes. It supports six languages, dark mode, table-of-contents scroll positioning, reading time, code highlighting, and configurable sidebar, fonts, and colors.

Hugo · Starter

risotto

risotto is a minimalist, responsive Hugo theme inspired by terminal ricing aesthetics. It uses semantic HTML and pure CSS with no JavaScript, and its layout relies on CSS Grid for native responsiveness without manual breakpoints.

Hugo · Starter