Gallery Deluxe

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 shuffle or reverse params to randomize or reverse gallery order.
• EXIF data — enable enable_exif to display metadata, with Hugo's EXIF filtering options.
• Watermark support — configure watermark with image path and position for large images.
• Custom thumbnails — copy and modify layouts/partials/gallerydeluxe/create-thumbs.html for 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.