Media · Gutenberg
Thumbnail Gallery block for WordPress
Large main image with a scrollable thumbnail strip navigation.
Get Blockenberg
Free Gutenberg block in Blockenberg. The inspector controls and front-end behavior on this page come from this block’s source, not a shared stub.
What it actually does
Large main image with a scrollable thumbnail strip navigation.
Inspector panels on this block: Images, Layout, Thumbnails, Options. Those titles come from index.js, not from a shared template.
Behavior controls: “Thumbnail Position” options: Bottom, Top, Left, Right; “Main Aspect Ratio” options: 16:9 Widescreen, 4:3 Standard, 3:2 Photo, 1:1 Square, 3:4 Portrait; “Image Fit” options: Cover, Contain; “Animation” options: Fade, Slide.
Where to find it
Gutenberg inserter → Media → search “Thumbnail Gallery” (block name `blockenberg/thumbnail-gallery` in block.json). Style it in the sidebar after insert.
How to use Thumbnail Gallery block for WordPress
- Install Blockenberg. Install from WordPress.org and activate the plugin.
- Insert the block. Edit a page, click +, search for “Thumbnail Gallery”, insert it. Category: Media.
- Configure inspector controls that exist on this block. Open Images. Set “Title”, “Caption”, “Alt Text”, “Thumbnail Position”.
- Check the published page. The view script reads HTML data attributes: data-opts, data-rendered. The block editor preview may not run the same view script.
Inspector controls from this block’s code
| Control | What the code does |
|---|---|
| Title | Text field in the inspector. |
| Caption | Text field in the inspector. |
| Alt Text | Text field in the inspector. |
| Thumbnail Position | Select control; the chosen value is saved on the block. Options: Bottom; Top; Left; Right. block.json default: bottom. Saved as `thumbPosition`. |
| Main Aspect Ratio | Select control; the chosen value is saved on the block. Options: 16:9 Widescreen; 4:3 Standard; 3:2 Photo; 1:1 Square; 3:4 Portrait. block.json default: 16/9. Saved as `mainAspect`. |
| Image Fit | Select control; the chosen value is saved on the block. Options: Cover; Contain. block.json default: cover. Saved as `mainObjectFit`. |
| Animation | Select control; the chosen value is saved on the block. Options: Fade; Slide. block.json default: fade. Saved as `animationType`. |
| Max Width (px) | Numeric range control in the inspector. Range 400–1600. block.json default: 900. Saved as `maxWidth`. |
| Thumbnail Size (px) | Numeric range control in the inspector. Range 40–160. block.json default: 72. Saved as `thumbSize`. |
| Thumbnail Gap (px) | Numeric range control in the inspector. Range 0–24. block.json default: 8. Saved as `thumbGap`. |
| Thumbnail Border Radius | Numeric range control in the inspector. Range 0–20. block.json default: 6. Saved as `thumbBorderRadius`. |
| Active Border Width (px) | Numeric range control in the inspector. Range 1–6. block.json default: 2. Saved as `thumbActiveBorderWidth`. |
| Show Captions | On/off toggle in the inspector. On by default. Saved as `showCaptions`. |
| Show Counter | On/off toggle in the inspector. On by default. Saved as `showCounter`. |
| Show Navigation Arrows | On/off toggle in the inspector. On by default. Saved as `showArrows`. |
| Show Zoom Button | On/off toggle in the inspector. On by default. Saved as `showZoom`. |
| Auto-Play | On/off toggle in the inspector. Off by default. Saved as `autoPlay`. |
| Auto-Play Delay (ms) | Numeric range control in the inspector. Range 1000–10000. block.json default: 4000. Saved as `autoPlayDelay`. |
| Main Border Radius | Numeric range control in the inspector. Range 0–32. block.json default: 12. Saved as `mainBorderRadius`. |
| Padding Top (px) | Numeric range control in the inspector. Range 0–120. block.json default: 0. Saved as `paddingTop`. |
| Padding Bottom (px) | Numeric range control in the inspector. Range 0–120. block.json default: 0. Saved as `paddingBottom`. |
| Colors — Background | Color control in the inspector. Saved as `bgColor`. |
| Main Image Background | Color control in the inspector. block.json default: #000000. Saved as `mainBg`. |
| Caption Background | Color control in the inspector. block.json default: rgba(0,0,0,0.6). Saved as `captionBg`. |
| Caption Text | Color control in the inspector. block.json default: #ffffff. Saved as `captionColor`. |
| Counter Background | Color control in the inspector. block.json default: rgba(0,0,0,0.55). Saved as `counterBg`. |
| Counter Text | Color control in the inspector. block.json default: #ffffff. Saved as `counterColor`. |
| Active Thumb Border | Color control in the inspector. block.json default: #6366f1. Saved as `thumbActiveBorder`. |
| Thumbnail Background | Color control in the inspector. block.json default: #e5e7eb. Saved as `thumbBg`. |
| Arrow Background | Color control in the inspector. block.json default: rgba(0,0,0,0.45). Saved as `arrowBg`. |
| Arrow Icon | Color control in the inspector. block.json default: #ffffff. Saved as `arrowColor`. |
What the front-end script actually does
- The view script reads HTML data attributes: data-opts, data-rendered.
- Keyboard handlers move focus between items.
When this is the right block
- Large main image with a scrollable thumbnail strip navigation — that is the job of Thumbnail Gallery, not a generic content block.
- Use it when you need the editor control labeled “Title”, which exists on this block’s inspector.
- It matches pages about gallery, thumbnail, images.
- Inserter grouping: video, animation, and rich media sections.
Notes from the implementation
viewScript: this folder’s frontend.js is enqueued on the front end for this block.
FAQ
How do I add the Thumbnail Gallery block in WordPress?
Install Blockenberg from WordPress.org, edit a page in the block editor, click +, and search for “Thumbnail Gallery”. It sits under Media. After insert, open Images and set “Title”, “Caption”, “Alt Text”, “Thumbnail Position”.
What makes Thumbnail Gallery different from other Blockenberg blocks?
Large main image with a scrollable thumbnail strip navigation. Inspector labels on this block include “Title”, “Caption”, “Alt Text”, “Thumbnail Position”.
Is the Thumbnail Gallery Gutenberg block free?
Yes. Thumbnail Gallery ships inside Blockenberg. Get the plugin from WordPress.org — no paid add-on is required for this block.
Can I style Thumbnail Gallery to match my theme?
Yes. Blockenberg’s shared typography and color panels apply here, plus any block-specific style controls listed on this page (panels: Images, Layout, Thumbnails, Options).
Related media blocks
Image Gallery
Responsive image gallery with grid/masonry layouts, lightbox, and hover effects.
Image Slider
A responsive image carousel with captions, autoplay, arrows, dots and touch support.
Image Cards
A responsive grid of rich cards with images, category tag, title, description and CTA. Perfect for blog previews, portfolio, services or team showcases.
Image Collage
Creative overlapping image composition with up to 5 images, custom rotations, positions, frames and a floating overlay card. Perfect for hero and about sections.
Lightbox Gallery
Image grid where clicking a thumbnail opens a full-screen lightbox with prev/next navigation.
Video Grid
Responsive grid of video cards with play-in-lightbox functionality. Supports YouTube, Vimeo, and self-hosted videos. Custom thumbnails, titles, and duration badges.
Get Blockenberg
Install Blockenberg from WordPress.org, then insert Thumbnail Gallery from the Gutenberg inserter.