Media module

Video Gallery block

YouTube, Vimeo or self-hosted videos in a grid or carousel. Videos open in a lightbox or play in place — and load only when clicked.

Overview

The Video Gallery shows several videos as thumbnails with a play button, in a grid or carousel. Clicking one opens it in a lightbox (with previous/next) or plays it in place. Players load only when a visitor clicks play, keeping the page fast; YouTube uses youtube-nocookie.com and Vimeo uses Do Not Track.

At a glance

Block name: wpbb/video-gallery
Module: Media
Find it by searching: Video Gallery
Loads JavaScript on the site: Yes, a small script, only on pages that use this block

When and why to use it

Testimonial and case-study videos.
Tutorial libraries.
Event recaps.

Example scenarios

Course page: six YouTube lessons in a 3-column grid, opening in a lightbox, with titles.

How to add the Video Gallery block

Open the editor. In your WordPress dashboard go to Pages (or Posts) and click the page you want to edit, or click Add New. For headers, footers and templates, use Appearance → Editor (block themes).
Add a new block. Click the blue + (Block Inserter) button in the top-left corner, or the small + that appears where you want the block. You can also type / on an empty line.
Search for the block. Type Video Gallery in the search field. Brigade Blocks appear in the Brigade Blocks category and show the coral block icon.
Insert it. Click Video Gallery in the results. The block appears with a field to add video links.
Configure the content. Paste a YouTube or Vimeo link (or a video file address) and click Add, or add files from the Media Library. Manage the list — titles, posters, order — in the Videos panel.
Customise the design. Switch to the Styles tab (half-filled circle icon) to change colours, spacing, borders and more — see Design & styling.
Save or publish. Click Save draft to keep working later, Preview to check it, or Publish / Update to make it live.

Content settings

You set up this block in two places: on the block itself in the editor, and in the Settings tab (gear icon) of the sidebar on the right. Every option is listed below, with its default value.

On the block (in the editor canvas)

Add a video URL

What it does: Adds videos to the gallery.
What to enter or choose: A YouTube or Vimeo link, or a video file (.mp4, .webm), then Add. Or Or add video files from the Media Library.
How to use it: Paste the link and click Add.
When to use it: Until all videos are added.
Example: https://vimeo.com/76979871.
Result: A thumbnail appears.

Settings panel: Videos

One entry per video (“Video 1 URL”, “Video 2 URL”…).

Video URL

What it does: The address of each video.
What to enter or choose: A YouTube or Vimeo link, or a video file (.mp4, .webm).
Default: None selected
How to use it: Each item is a collapsible row. Click it to open its fields; use the arrows to reorder, the bin to delete and “Add” to create a new one.
When to use it: Always.
Example: A YouTube “watch” link.
Result: The thumbnail updates.

Title

What it does: The video title.
What to enter or choose: Short text.
How to use it: Type into the text field. Changes appear in the preview right away.
When to use it: Recommended — it is also the accessible name of the play button.
Example: “Lesson 1: Getting set up”.
Result: Shown under the thumbnail when Show titles is on.

Custom poster

What it does: A custom thumbnail image.
What to enter or choose: Custom poster / Replace poster / Remove poster.
How to use it: Click the button to open the Media Library, then upload a new file or pick an existing one and click “Select”.
When to use it: For Vimeo and video files (which have no automatic thumbnail), or to replace YouTube’s.
Example: A branded still.
Result: Without one, YouTube videos use their own thumbnail.

Move up / Move down / Remove

What it does: Reorders or removes a video.
What to enter or choose: Click a button.
How to use it: Select the block; the button is in the toolbar that appears above it.
When to use it: Anytime.
Example: Move the intro video first.
Result: The gallery updates.

Settings panel: Layout

Layout

What it does: Grid or swipeable carousel.
What to enter or choose: One of: Grid, Carousel.
Default: Grid
How to use it: Click one of the buttons in the group.
When to use it: Always optional.
Example: Carousel for many videos.
Result: The arrangement changes.

Columns (desktop)Desktop

What it does: Items per row on large screens.
What to enter or choose: A number from 1 to 6.
Default: 3
How to use it: Drag the slider, or type a number in the box next to it.
When to use it: Always.
Example: 3.
Result: Items resize to fit.

Columns (tablet)Tablet

What it does: Items per row below 1024px.
What to enter or choose: A number from 1 to 4.
Default: 2
How to use it: Drag the slider, or type a number in the box next to it.
When to use it: Always.
Example: 2.
Result: Applies up to 1023px wide.

Columns (mobile)Mobile

What it does: Items per row below 600px.
What to enter or choose: A number from 1 to 3.
Default: 1
How to use it: Drag the slider, or type a number in the box next to it.
When to use it: Always.
Example: 1.
Result: Applies up to 599px wide.

Gap (px)

What it does: Space between items.
What to enter or choose: A number from 0 to 80 (px).
Default: 24 px
How to use it: Drag the slider, or type a number in the box next to it.
When to use it: Always optional.
Example: 8 for a tight mosaic.
Result: Items move closer or further apart.

Aspect ratio

What it does: Thumbnail and player shape.
What to enter or choose: One of: 16:9, 4:3, 1:1, 9:16 (vertical).
Default: 16:9
How to use it: Open the dropdown and pick an option.
When to use it: Match your videos.
Example: 9:16 for Shorts or Reels.
Result: All thumbnails use this shape.

Settings panel: Playback

Help text: “Players load only when a visitor clicks play. YouTube uses youtube-nocookie.com and Vimeo uses Do Not Track.”

Play videos

What it does: Where videos play.
What to enter or choose: One of: In a lightbox, In place.
Default: In a lightbox
How to use it: Click one of the buttons in the group.
When to use it: Lightbox for grids (bigger player, previous/next); In place for carousels or single rows.
Example: In a lightbox.
Result: Clicking plays the video there.

Show titles

What it does: Shows titles under thumbnails.
What to enter or choose: On or off.
Default: On
How to use it: Click the switch to turn it on (blue) or off.
When to use it: Usually.
Example: On.
Result: Titles appear.

Settings panel: Carousel

Only shown for the Carousel layout.

Arrows

What it does: Shows previous/next arrow buttons.
What to enter or choose: On or off.
Default: On
How to use it: Click the switch to turn it on (blue) or off.
When to use it: Keep on for desktop visitors.
Example: On.
Result: Arrows at the sides.

Dots

What it does: Shows a dot per page below the slides.
What to enter or choose: On or off.
Default: On
How to use it: Click the switch to turn it on (blue) or off.
When to use it: To show how many slides there are.
Example: On.
Result: Clickable dots.

Loop

What it does: After the last slide, continues from the first.
What to enter or choose: On or off.
Default: On
How to use it: Click the switch to turn it on (blue) or off.
When to use it: Usually on.
Example: On.
Result: Arrows never become disabled.

Autoplay

What it does: Advances slides automatically.
What to enter or choose: On or off.
Default: Off
How to use it: Click the switch to turn it on (blue) or off.
When to use it: Use sparingly — moving content distracts.
Example: On for a hero slider.
Result: Pauses on hover and focus, shows a pause button, and never runs for visitors who prefer reduced motion.

Delay (seconds)Shown when Autoplay is on

What it does: Time each slide stays.
What to enter or choose: A number from 2 to 15 (s).
Default: 5 seconds
How to use it: Drag the slider, or type a number in the box next to it.
When to use it: Longer for slides with text.
Example: 6.
Result: Slower or faster autoplay.

Design & styling

Select the block, open the Styles tab in the settings sidebar (the half-filled circle icon next to the gear) and use the three pickers at the top of the Style panel:

Element — which part of the block to style.
State — Normal, or a state such as Hover (only the states the part supports are offered).
Device — Desktop, Tablet or Mobile, for values that can differ per screen size.

Only panels that make sense for the chosen part and state are shown. The full meaning of every control is in the Styling Controls guide; below is exactly what Video Gallery offers.

Element: Video thumbnail selected first

Each thumbnail. Hover state.

Styles-tab controls for “Video thumbnail”
Panel	Control	Per device	Available in states
Border	Border type	—	Normal, Hover
	Border	—	Normal, Hover
	Radius	Yes	Normal
Box Shadow	Remove shadow	—	Normal, Hover
Box Shadow	Shadow layers	—	Normal, Hover

States for this part:

Hover — When the mouse pointer is over the whole block — so this part changes as soon as visitors point at the block.

Element: Block

The whole block.

Styles-tab controls for “Block”
Panel	Control	Per device	Available in states
Background	Type	—	Normal
	Color / Gradient	—	Normal
	Image	—	Normal
Border	Border type	—	Normal
	Border	—	Normal
	Radius	Yes	Normal
Box Shadow	Remove shadow	—	Normal
Box Shadow	Shadow layers	—	Normal
Spacing	Margin	Yes	Normal
Spacing	Padding	Yes	Normal
Sizing	Width	Yes	Normal
	Max width	Yes	Normal
	Height	Yes	Normal
	Min width / Min height / Max height	Yes	Normal
	Block alignment	Yes	Normal
Position	Position	Yes	Normal
	Top / Right / Bottom / Left	Yes	Normal
	Z-index	Yes	Normal
	Overflow	Yes	Normal
Transform	Move X / Move Y	—	Normal
	Scale X / Scale Y	—	Normal
	Rotate (°), Rotate X (°), Rotate Y (°)	—	Normal
	Skew X (°) / Skew Y (°)	—	Normal
Effects	Opacity (%)	Yes	Normal
	State transition (ms)	—	Normal
	Timing	—	Normal
Visibility	Show on Desktop / Tablet / Mobile	—	Normal

States: Normal only.

Element: Play button

The play buttons. Hover state (thumbnail hovered).

Styles-tab controls for “Play button”
Panel	Control	Per device	Available in states
Colors	Text	—	Normal, Hover
Background	Type	—	Normal, Hover
	Color / Gradient	—	Normal, Hover
	Image	—	Normal
Border	Radius	Yes	Normal
Box Shadow	Remove shadow	—	Normal, Hover
Box Shadow	Shadow layers	—	Normal, Hover
Sizing	Width	Yes	Normal
	Max width	Yes	Normal
	Height	Yes	Normal
	Min width / Min height / Max height	Yes	Normal

States for this part:

Hover — When the mouse pointer is over the whole block — so this part changes as soon as visitors point at the block.

Element: Title

Video titles.

Styles-tab controls for “Title”
Panel	Control	Per device	Available in states
Typography	Font family	—	Normal
	Font size	Yes	Normal
	Weight	—	Normal
	Style	—	Normal
	Line height	Yes	Normal
	Letter spacing	Yes	Normal
	Letter case	—	Normal
	Alignment	Yes	Normal
	Decoration	—	Normal
Colors	Text	—	Normal

States: Normal only.

Element: Carousel arrows

Carousel arrows.

Styles-tab controls for “Carousel arrows”
Panel	Control	Per device	Available in states
Colors	Text	—	Normal, Hover, Focus
Background	Type	—	Normal, Hover, Focus
	Color / Gradient	—	Normal, Hover, Focus
	Image	—	Normal
Border	Border type	—	Normal, Hover, Focus
	Border	—	Normal, Hover, Focus
	Radius	Yes	Normal
Box Shadow	Remove shadow	—	Normal, Hover, Focus
Box Shadow	Shadow layers	—	Normal, Hover, Focus
Sizing	Width	Yes	Normal
	Max width	Yes	Normal
	Height	Yes	Normal
	Min width / Min height / Max height	Yes	Normal

States for this part:

Hover — When the mouse pointer is over it. (Touch screens have no hover; they show the normal style.)
Focus — When it has keyboard focus — reached with the Tab key. Mouse clicks usually do not show focus styles.

Element: Carousel dots

Carousel dots. Active = current slide.

Styles-tab controls for “Carousel dots”
Panel	Control	Per device	Available in states
Background	Type	—	Normal, Active
	Color / Gradient	—	Normal, Active
	Image	—	Normal
Border	Radius	Yes	Normal
Sizing	Width	Yes	Normal
	Max width	Yes	Normal
	Height	Yes	Normal
	Min width / Min height / Max height	Yes	Normal

States for this part:

Active — The selected / current item ([aria-current="true"]).

Responsive settings

Brigade Blocks uses three screen sizes: Desktop (wider than 1023px), Tablet (600–1023px) and Mobile (599px and narrower). Tablet and Mobile values are optional: when empty, the value of the next larger screen is used.

In the Styles tab, pick the Device first; these controls can then have a different value for that screen size: Radius, Margin, Padding, Width, Max width, Height, Min width / Min height / Max height, Block alignment, Position, Top / Right / Bottom / Left, Z-index, Overflow, Opacity (%), Font size, Line height, Letter spacing, Alignment.

The Visibility panel (Styles tab, Normal state) can hide the block entirely on Desktop, Tablet or Mobile.

Advanced options

HTML anchor (Advanced section of the Settings tab) — a unique name such as pricing, so you can link straight to this block with #pricing at the end of the page address (for example from a menu).
Additional CSS class(es) (Advanced section) — for custom CSS from your theme or the Site Editor. Separate several classes with spaces.
Custom attributes (Advanced section) — add data-*, title, aria-label, aria-describedby, lang or dir attributes. See Custom attributes.
State transition (Styles tab → Effects, Normal state) — how smoothly hover and focus styles animate.
Width alignment (block toolbar) — Wide width, Full width, when your theme supports them.

How it works on your site

Each thumbnail is a link to the video, so it works without JavaScript. With JavaScript, the lightbox or in-place player loads the video only on click; videos stop when the lightbox moves on or closes.

Accessibility

Each thumbnail link is announced as “Play video: title”.
The lightbox keeps focus inside, closes with Esc, and returns focus to the thumbnail.

Limitations and notes

Only YouTube, Vimeo and direct video files are supported.
Vimeo and video files need a custom poster to show a thumbnail image.
Up to 60 videos per gallery.