Media · Gutenberg
Gallery Showcase block for WordPress
Featured image with a clickable thumbnail strip — click any thumbnail to swap the main large view. Perfect for portfolio details, product image galleries, and case study illustrations.
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
Featured image with a clickable thumbnail strip — click any thumbnail to swap the main large view. Perfect for portfolio details, product image galleries, and case study illustrations.
Inspector panels on this block: Display, Captions, Navigation, Lightbox, Images. Those titles come from index.js, not from a shared template.
Behavior controls: “Thumbnail position” options: Bottom, Top, Left, Right; “Main aspect ratio” options: 4 / 3, 16 / 9, 1 / 1, 3 / 2; “Main fit” options: Cover, Contain; “Caption position” options: Overlay, Below.
Where to find it
Gutenberg inserter → Media → search “Gallery Showcase” (block name `blockenberg/gallery-showcase` in block.json). Style it in the sidebar after insert.
How to use Gallery Showcase block for WordPress
- Install Blockenberg. Install from WordPress.org and activate the plugin.
- Insert the block. Edit a page, click +, search for “Gallery Showcase”, insert it. Category: Media.
- Configure inspector controls that exist on this block. Open Display. Set “Thumbnail position”, “Main aspect ratio”, “Main fit”, “Main radius (px)”.
- Check the published page. The view script reads HTML data attributes: data-caption, data-keyboard, data-lightbox. The block editor preview may not run the same view script.
Inspector controls from this block’s code
| Control | What the code does |
|---|---|
| Thumbnail position | Select control; the chosen value is saved on the block. Options: Bottom; Top; Left; Right. block.json default: bottom. Saved as `thumbnailPosition`. |
| Main aspect ratio | Select control; the chosen value is saved on the block. Options: 4 / 3; 16 / 9; 1 / 1; 3 / 2. block.json default: 4/3. Saved as `mainAspect`. |
| Main fit | Select control; the chosen value is saved on the block. Options: Cover; Contain. block.json default: cover. Saved as `mainObjectFit`. |
| Main radius (px) | Numeric range control in the inspector. Range 0–40. block.json default: 16. Saved as `mainRadius`. |
| Thumbnail radius (px) | Numeric range control in the inspector. Range 0–20. block.json default: 8. Saved as `thumbnailRadius`. |
| Thumbnail gap (px) | Numeric range control in the inspector. Range 2–24. block.json default: 8. Saved as `thumbnailGap`. |
| Show image shadow | On/off toggle in the inspector. On by default. Saved as `mainShadow`. |
| Show counter badge | On/off toggle in the inspector. On by default. Saved as `showCounter`. |
| Show captions | On/off toggle in the inspector. On by default. Saved as `showCaption`. |
| Caption position | Select control; the chosen value is saved on the block. Options: Overlay; Below. block.json default: overlay. Saved as `captionPosition`. |
| Show arrows | On/off toggle in the inspector. On by default. Saved as `showArrows`. |
| Arrow style | Select control; the chosen value is saved on the block. Options: Circle; Square; Minimal. block.json default: circle. Saved as `arrowStyle`. |
| Transition type | Select control; the chosen value is saved on the block. Options: Fade; Slide. block.json default: fade. Saved as `transitionType`. |
| Transition duration (ms) | Numeric range control in the inspector. Range 100–1000. block.json default: 320. Saved as `transitionDuration`. |
| Enable lightbox | On/off toggle in the inspector. On by default. Saved as `enableLightbox`. |
| Keyboard navigation | On/off toggle in the inspector. On by default. Saved as `enableKeyboard`. |
| Show zoom button | On/off toggle in the inspector. Off by default. Saved as `showZoom`. |
| Active border width (px) | Numeric range control in the inspector. Range 1–6. block.json default: 3. Saved as `activeBorderWidth`. |
| Padding top (px) | Numeric range control in the inspector. Range 0–200. block.json default: 40. Saved as `paddingTop`. |
| Padding bottom (px) | Numeric range control in the inspector. Range 0–200. block.json default: 40. Saved as `paddingBottom`. |
What the front-end script actually does
- The view script reads HTML data attributes: data-caption, data-keyboard, data-lightbox.
- Keyboard handlers move focus between items.
When this is the right block
- Featured image with a clickable thumbnail strip — click any thumbnail to swap the main large view. Perfect for portfolio details, product image galleries, and case study illustrations — that is the job of Gallery Showcase, not a generic content block.
- Use it when you need the editor control labeled “Thumbnail position”, which exists on this block’s inspector.
- It matches pages about gallery, showcase, thumbnails.
- 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 Gallery Showcase block in WordPress?
Install Blockenberg from WordPress.org, edit a page in the block editor, click +, and search for “Gallery Showcase”. It sits under Media. After insert, open Display and set “Thumbnail position”, “Main aspect ratio”, “Main fit”, “Main radius (px)”.
What makes Gallery Showcase different from other Blockenberg blocks?
Featured image with a clickable thumbnail strip — click any thumbnail to swap the main large view. Perfect for portfolio details, product image galleries, and case study illustrations. Inspector labels on this block include “Thumbnail position”, “Main aspect ratio”, “Main fit”, “Main radius (px)”.
Is the Gallery Showcase Gutenberg block free?
Yes. Gallery Showcase ships inside Blockenberg. Get the plugin from WordPress.org — no paid add-on is required for this block.
Can I style Gallery Showcase 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: Display, Captions, Navigation, Lightbox).
Related media blocks
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.
Before / After Grid
A grid of interactive before/after image comparison sliders — show multiple transformations, makeovers, or design iterations in one layout.
Filter Gallery
Image grid with category filter buttons. Clicking a tag shows/hides matching items with animation.
Image Accordion
Expandable image panels that stretch open on hover or click — ideal for showcasing portfolios, services, or locations.
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.
Image Gallery
Responsive image gallery with grid/masonry layouts, lightbox, and hover effects.
Get Blockenberg
Install Blockenberg from WordPress.org, then insert Gallery Showcase from the Gutenberg inserter.