Horsify Knowledge Base - Gallery Block Quick Reference

Three Display Styles

Grid Layout

Best for: Event photos, team photos, sponsor logos — and anything where you want filtering, sharing or favourites

2, 3 or 4 columns (configurable)
Square images, cropped to fit
Hover zoom + caption and photo-credit reveal
Click for the lightbox
Every one of the extra features below works on this layout

Masonry Layout

Best for: Mixed photo sizes, competition galleries

Natural image heights
Pinterest-style cascading
1–3 columns (responsive; the Number of Columns setting does not apply)
Caption and photo-credit reveal on hover
Tag filtering, photo album tabs and favourites, the same as Grid
Click for the lightbox, with sharing, download and zoom

Slideshow

Best for: Hero galleries, feature highlights

Auto-play (optional; 3, 5, 7 or 10 seconds)
Previous/Next buttons
Slide indicators (dots)
Captions overlay
Keyboard navigation (arrow keys)
Pause on hover
Click for the lightbox, with sharing, download, zoom and the photo credit
No tag filtering, album tabs or favourites — one image is on screen at a time, so there's no list to filter and nowhere to put a heart

What Works on Which Layout

Grid and Masonry do everything. Three options — tag filtering, photo album tabs and favourites — don't work on the Slideshow, because it shows one image at a time and so has no list of images to filter. The editor greys those tick boxes out and hides the album controls when Slideshow is the selected style, so you can't switch on something that won't appear:

Feature	Grid	Masonry	Slideshow
Lightbox	✅	✅	✅
Zoom & pan in the lightbox	✅	✅	✅
Captions	✅	✅	✅
Tag filtering	✅	✅	—
Photo album tabs	✅	✅	—
Favourites	✅	✅	—
Social sharing	✅	✅	✅
Image download	✅	✅	✅
Photographer credit	✅	✅	✅ (lightbox only)

If you want filtering, albums or favourites, choose Grid or Masonry.

The Extra Features (Grid and Masonry)

Sharing, image download, photographer credits and zoom work on the Slideshow too. Tag filtering, photo albums and favourites are the three that need Grid or Masonry.

Tag Filtering

Tag images (e.g. "Jumping", "Dressage")
Filter buttons are generated automatically from the tags you've used
Visitors click to show or hide categories

Social Sharing

Share to Facebook or Pinterest
Copy image link
On mobile, the device's own share sheet is used where the browser supports it

Image Download

A download button in the lightbox, for the full-size image

Photo Albums

Organise images into named collections
Album tabs let visitors switch between them
Example: "Summer 2026", "Members"

Favourites

Heart an image to save it
Stored in the visitor's own browser — no login, and not visible to you
A "Favourites" filter button shows only the hearted images
The heart appears when the image is hovered (tapped, on a phone)

Photographer Credits

Shown under the caption on hover, and in the lightbox

Zoom & Pan (All Layouts)

On by default, and available in the lightbox on every layout:

Zoom in/out with the controls
Mouse wheel to zoom
Pinch-to-zoom on mobile
Drag to pan when zoomed in

Adding Images

Pick from Library — select images your club has already uploaded
Add by URL — enter an image address manually
Upload — drag and drop, or browse. JPG, PNG, WebP or SVG, up to 5 MB each, and up to 10 files at a time

Required Fields

✅ Display Style — choose the layout
✅ Images — at least 1 image
✅ Alt Text — for every image (accessibility)

Optional Per-Image Fields

Caption — shown on hover and in the lightbox
Tags — for filtering (comma-separated)
Album — assign to an album (only appears once you've created one)
Photographer — photo credit

Responsive Behaviour

Columns adapt to the screen. The Number of Columns setting is the desktop figure, and only applies to Grid:

Setting	Phone	Tablet	Desktop
Grid — 2 columns	1	2	2
Grid — 3 columns	1	2	3
Grid — 4 columns	2	3	4
Masonry	1	2	3
Slideshow	1	1	1

Accessibility

Alt text is required on every image and is used by screen readers
The slideshow is keyboard-navigable (arrow keys) and the lightbox closes with Esc
Buttons carry labels and visible focus styling

Quick Tips

💡 Grid: use 3 columns for the best balance 💡 Masonry: works best with 8–15 images 💡 Slideshow: keep to 5–7 images max 💡 Alt Text: be specific, not generic 💡 Captions: keep under 2 lines 💡 Tags: use consistent naming (always "Jumping", not "jumping") 💡 Albums: great for organising 20+ images — and remember they need Grid or Masonry 💡 Compress before uploading: the 5 MB limit is generous, but a page of 5 MB photos is slow on a phone

Feature Combinations

🏆 Best for large events:

Grid layout
Enable Tag Filtering (by discipline)
Enable Favourites
Enable Social Sharing

🎪 Best for facility tours:

Grid or Masonry layout with Photo Albums (Arenas, Stables, Amenities)
Photographer credits

📱 Best for social media:

Grid layout
Enable Social Sharing
Enable Image Download
High-quality images

👥 Best for member galleries:

Grid layout (4 columns)
Enable Favourites
Enable Tag Filtering (by year or event)

Image Recommendations

Size: 1200px+ width (1920px for slideshow)
Format: JPEG, PNG, WebP or SVG
File Size: under 5 MB per file (the upload limit); compress to a few hundred KB where you can
Aspect Ratio: any (Grid crops to square, Masonry and Slideshow preserve the original)

Keyboard Shortcuts

Tab — navigate to controls
Enter/Space — activate buttons
←/→ — previous/next slide (slideshow)
Esc — close the lightbox
Mouse wheel — zoom in/out (when the lightbox is open)

Mobile

Pinch-to-zoom — zoom images in the lightbox
Drag — pan a zoomed image
Share sheet — the device's native share dialog is used where the browser supports it

Gallery Block Quick Reference