You can add videos to a WordPress gallery with the Modula Video extension. It works with YouTube, Vimeo and self-hosted (MP4) videos, which are files stored on your own site. You can also build a Video gallery: one big player with a playlist beside it.
Note: Video is part of Modula Pro, included from the Starter plan. Turn it on in Modula → Extensions (see how to install extensions).
Add videos to a WordPress gallery
- Go to Modula → Galleries and open the gallery.
- Click the arrow next to Add.
-
Choose A video.

-
Paste the link in Video or playlist link.

- Click Add. The video joins the gallery, with a play icon on its thumbnail.
For a self-hosted video, upload the MP4 file in Media → Library first. Open the file and click Copy URL to clipboard. Then paste that link in the steps above.
Add a whole playlist
A playlist adds many videos at once. Playlists need your YouTube or Vimeo account connected in Modula → Settings → Connections.
The steps are in Connect Modula to YouTube and Connect Modula to Vimeo.
- In the same menu, choose A video playlist.
- Paste a YouTube playlist, a Vimeo channel or a public Vimeo Showcase link. Every video in it is added to the gallery.
Turn an image into a video
An image can also open a video. The image stays as the thumbnail in the gallery, and the video plays in the lightbox. The lightbox is the window that opens over the page when someone clicks an item.
- Click the image in the gallery.
- Click Edit image to open its panel.
- Under More settings, open Video.
- Paste the YouTube, Vimeo or MP4 link in Video URL.
- You can also add a Video thumbnail URL. It shows in the lightbox navigation. It is also the poster of a self-hosted video, which is the picture shown before the video plays.
-
Autoplay thumbnail, Autoplay in lightbox and Loop video change the gallery’s video settings for this one item. Leave them on Default to follow the gallery, or pick On or Off.

Video settings for the whole gallery
Once your videos are in, you can decide how they play. In the gallery editor, click Video in the left rail. These settings apply to every video in the gallery.

- Autoplay in lightbox: The video starts by itself when it opens in the lightbox, without a click on play.
- Repeat when it ends: The video starts again from the beginning when it ends. This also loops self-hosted videos, with no code needed.
- Show the play icon: Shows the icon on the video thumbnails. Pick an Icon, or use your own with Image file. A square PNG with transparency works best. Colour and Size change the icon, and the size can be different on desktop, tablet and phone.
- Preview on hover: The thumbnail plays the video when a visitor hovers over it. Preview length sets how many seconds it plays before going back to the thumbnail, from 1 to 30 (3 by default). Start playing by itself plays the previews as soon as the gallery loads, without a hover.
Note: On iPhone and iPad, autoplay works only for self-hosted videos, and they play muted. See Apple’s video policies.
Make a Video gallery
A Video gallery shows one video at a time in a large player. The other videos sit in a playlist next to it or under it.
- In the gallery editor, click Layout.
- Set Type to Video gallery.
- Click Video.
-
Choose the Playlist position: Right or Bottom. The play icon settings work here too.

Note: A Video gallery plays the videos in its own player. It has no Lightbox or Interact section, and the lightbox autoplay, repeat and hover preview settings don’t apply to it.
For a full walkthrough of one gallery with photos and videos, see how to create a photo and video gallery in WordPress.
Fix common video thumbnail problems
Two problems come up most often. Both have to do with the thumbnail, so the fixes take only a minute.
If a Vimeo video has black borders
Vimeo gives Modula a small thumbnail for its videos, about 295 × 166 pixels. That is much smaller than your other images. The video is then sized from that thumbnail, so on your site it shows with wide black borders.
To fix it, remove the thumbnail link:
- Click the video in the gallery.
- Click Edit video to open its panel.
- Under More settings, open Video.
- Delete the link in Video thumbnail URL.
- Check the gallery on your site.
Instead of emptying the field, you can paste the link of a larger image there, about the size of the other images in the gallery.
If a self-hosted video shows “No Image Available”
A self-hosted (MP4) video has no picture of its own. Modula shows a gray “No Image Available” placeholder until you give it one.
To fix it, use an image as the thumbnail. Add the image to the gallery and turn it into a video, with the MP4 link in Video URL.