Your First Gallery

Four steps: get photos in, describe them, save a display, paste the shortcode. About five minutes for a small batch.

1UploadDrag photos in2DescribeFill your fields3Build a displayPick photos + layout4PasteShortcode on a page
The whole workflow. Everything else in these docs is a detail of one of these four steps.

1. Upload some photos

Go to JMGallery › Upload and drag a folder of photos onto the drop zone. They upload two at a time with progress bars.

Before you drag anything in, fill the panel on the right with whatever these photos have in common — the album name, the year, the place. Every photo in the batch is saved with those values, so a hundred photos from one trip get described once instead of a hundred times.

Photos already in your Media Library can be pulled in from the picker further down the same screen. More in Adding photos.

2. Check your fields

JMGallery › Fields is where you decide what a photo record holds. Six fields are set up for you. Rename them, reorder them, delete the ones that do not fit your collection, add your own.

For each field you choose four things: whether it shows as a column in the library, whether it becomes a filter, whether it appears on the item page, and whether it can go in a caption. More in Custom fields.

3. Build a display

A display is a saved answer to two questions: which items, and what they look like. Go to JMGallery › Displays and click + New display.

  • Under Which items, filter on any field. Leave everything blank to show the whole library.
  • Under Layout, pick grid, masonry or list, then columns, spacing and corner radius.
  • Under Captions, tick the fields you want under or over each photo.
  • Click Preview to see it, then Save display.

4. Put it on a page

Saving gives the display a shortcode. Copy it and paste it into any page, post, or widget:

100 items
Girl sitting on office building step
Girl sitting on office building stepPeople / May 3, 2025 / Photo / $0.99
Man sitting on city step
Man sitting on city stepPeople / January 3, 2026 / Photo / $1.99
Man looking at sunset
Man looking at sunsetPeople / May 15, 2026 / Photo
Woman carrying kid on her back, both laughing
Woman carrying kid on her back, both laughingPeople / December 3, 2025 / Photo
Woman high fiving a little girl at a sporting event
Woman high fiving a little girl at a sporting eventPeople / December 3, 2025 / Photo
Woman with camera
Woman with cameraPeople / December 3, 2025 / Photo
Man and Woman on a mountain top
Man and Woman on a mountain topPeople / December 3, 2025 / Photo
Woman doing square finger gesture
Woman doing square finger gesturePeople / December 3, 2025 / Photo
Man in shirt and tie giving a thumbs up
Man in shirt and tie giving a thumbs upPeople / December 3, 2025 / Photo
Woman running
Woman runningPeople / December 3, 2025 / Photo
Man balance on a rope
Man balance on a ropePeople / March 15, 2026 / Illustrated
Woman smiling
Woman smilingPeople / March 15, 2026 / Illustrated
African American family cooking a meal
African American family cooking a mealPeople / March 15, 2026 / Illustrated
Green Forest
Green ForestNature / March 5, 2026 / Photo
School of Fish
School of FishNature / March 5, 2026 / Photo
Sun beaming through forest canopy
Sun beaming through forest canopyNature / March 5, 2026 / Photo
Mountain Lake
Mountain LakeNature / March 5, 2026 / Photo
Mountain view with clouds
Mountain view with cloudsNature / March 5, 2026 / Photo
Sun beaming through green forest canopy
Sun beaming through green forest canopyNature / March 5, 2026 / Photo
Field with mountain backdrop
Field with mountain backdropNature / March 5, 2026 / Field, Mountains, Photo
Sunset reflecting off lake
Sunset reflecting off lakeNature / March 5, 2026 / Photo
Sun over forest and mountain range
Sun over forest and mountain rangeNature / March 1, 2026 / Illustrated
A large tree with autumn leaves in a forest
A large tree with autumn leaves in a forestNature / March 1, 2026 / Illustrated
Sunset Lake Island Reflection
Sunset Lake Island ReflectionNature / March 1, 2026 / Illustrated

That is the gallery live. You can override any layout setting for one page without touching the saved display:

100 items
Image Galleries That Load Fast
Image Galleries That Load Fast
Custom Fields for Everyday Sites
Custom Fields for Everyday Sites
Elementor vs the Block Editor
Elementor vs the Block Editor
elementor-vs-the-block-editor-demo.webp
elementor-vs-the-block-editor-demo.webp
Building Post Grids Without Code
Building Post Grids Without Code
Backups You Will Actually Restore
Backups You Will Actually Restore
Speeding Up a Slow WordPress Site
Speeding Up a Slow WordPress Site
Choosing a Theme That Grows With You
Choosing a Theme That Grows With You

Where to go next