Gallery Deluxe is a Hugo module and theme that renders photo galleries quickly, designed by GitHub user bep and proven on staticbattery.com with perfect PageSpeed scores.
What is Gallery Deluxe?
Gallery Deluxe is a photo gallery theme built as a Hugo Module for the Hugo static site generator. It takes images from your project and outputs a browsable gallery with thumbnails and large views, optimized to handle many images without slowing down. The repository is maintained by bep and includes a starter template at bep/gallerydeluxe_starter for quick setup.
Key Features
- Hugo Module — install via Hugo Modules; a starter template at bep/gallerydeluxe_starter gives a fast route.
- Performance focus — powers staticbattery.com, scoring 100 on Google PageSpeed for mobile and desktop.
- Shuffle and reverse — set
shuffleorreverseparams to randomize or reverse gallery order. - EXIF data — enable
enable_exifto display metadata, with Hugo's EXIF filtering options. - Watermark support — configure
watermarkwith image path and position for large images. - Custom thumbnails — copy and modify
layouts/partials/gallerydeluxe/create-thumbs.htmlfor full control. - Pig.js credit — uses Dan Schlosser's Pig.js library for gallery behavior.
Who is it for?
- Photographers — display a portfolio gallery on a static site with fast loading.
- Hugo site owners — add a gallery section without building a custom template.
- Developers — customize thumbnail generation and image processing via the partial.
- Performance-focused sites — get high PageSpeed scores with large image sets.
What can you do with Gallery Deluxe?
- Photographers: publish a photo gallery that loads quickly and supports shuffle/reverse for fresh views.
- Site owners: add a watermark overlay to large images to protect copyright.
- Developers: override the thumbnail partial to control exact image output.
How do you configure Gallery Deluxe?
Add it as a Hugo module using the starter template, then set params.gallerydeluxe in your config: shuffle, reverse, enable_exif, and an optional watermark block with image path and position. For multiple galleries, use Galleries Deluxe (bep/galleriesdeluxe).
FAQ
Is Gallery Deluxe free?
Gallery Deluxe is a public GitHub repository distributed as a Hugo module; no license or pricing is mentioned on the page, so it is available for use from the repository.
How do I install Gallery Deluxe?
The recommended route is the Gallery Deluxe Starter (bep/gallerydeluxe_starter), which provides a fast setup. The README also points to staticbattery.com as an example site.
Can I set a watermark?
Yes, configure params.gallerydeluxe.watermark with image (relative to /assets), posx (left/center/right), and posy (top/center/bottom).
Does Gallery Deluxe support EXIF?
Yes, set enable_exif = true; Hugo's image processing documentation describes how to filter EXIF tags.
