---
title: "How to Create WordPress YouTube Video Gallery?"
url: https://nexterwp.com/docs/create-wordpress-youtube-video-gallery/
date: 2023-06-17
modified: 2026-09-14
lang: en
author: "Aditya Sharma"
description: "Embedding YouTube videos one per page spreads your best content thin. The Media Listing block puts them in a single gallery, with each item identified by its YouTube video ID...."
image: https://nexterwp.com/wp-content/uploads/2024/05/create-wordpress-youtube-video-gallery-1024x519.jpg
word_count: 334
---

# How to Create WordPress YouTube Video Gallery?

## Key Takeaways

- Nexter Blocks Media Listing block creates a WordPress YouTube video gallery by selecting Videos in Type, choosing a listing style and layout, and setting Popup Layout to Default.
- Media Listing block uses YouTube as the Source, adds the video ID in the Youtube Id field, and uploads an overlay image so the thumbnail becomes clickable.
- Media Listing block lets a user add multiple YouTube videos with the +Add content button, and Box Link under Extra Options makes the entire thumbnail clickable when Force Custom URL stays off.

Embedding YouTube videos one per page spreads your best content thin.

The Media Listing block puts them in a single gallery, with each item identified by its YouTube video ID.

*For every Media Listing setting in one place, see the [Media Listing block guide](https://nexterwp.com/docs/add-media-listing-in-wordpress/).*

[LIVE BLOCK LINK](https://nexterwp.com/nexter-blocks/listing/wordpress-image-gallery/)

## Before You Start

- **Edition:** **Pro** — the Media Listing block is part of Nexter Blocks Pro.- **Block to enable:** Media Listing, switched on under **Nexter > Blocks** in your WordPress dashboard.- **Your video IDs:** the part of a YouTube URL after *watch?v=* or after *youtu.be/*.

## Steps

- Add the **Media Listing** block to your page and click **Design from Scratch**.

- In the **Layout** panel, set **Type** to **Videos**.

![The Layout panel with the Type setting set to Videos](https://nexterwp.com/wp-content/uploads/2026/09/media-listing-type.webp)

- Open the **Content** panel and click **+ Add Item** for each video.

- Set **Source** to **YouTube**.

![The Source setting on a video item](https://nexterwp.com/wp-content/uploads/2026/09/media-listing-video-source.webp)

- Paste the video ID into **YouTube ID**. Use the ID on its own, not the whole URL.

![The YouTube ID field on a video item](https://nexterwp.com/wp-content/uploads/2026/09/media-listing-video-youtube.webp)

- Add a **Title** and a thumbnail **Image**, set your **Layout** and **Columns**, then publish.

![A gallery of YouTube videos with their titles](https://nexterwp.com/wp-content/uploads/2026/09/media-listing-fe-videos.webp)

## Finding the Video ID

| YouTube URL | The ID to paste |
| ----------- | --------------- |
| youtube.com/watch?v=2ReiWfKUxIM | 2ReiWfKUxIM |
| youtu.be/2ReiWfKUxIM | 2ReiWfKUxIM |
| youtube.com/embed/2ReiWfKUxIM | 2ReiWfKUxIM |

## How It Behaves

- Each item is turned into a standard YouTube embed address built from the ID you paste.- Nothing loads from YouTube until a visitor plays a video, so a long gallery stays light.- Source is per item, so a YouTube gallery can include a Vimeo or self hosted video alongside.- The thumbnail is the image you choose, not the one from YouTube, so you can keep the tiles consistent.

## Limitations

- **Pro only.**- Videos are added one at a time. Channels and playlists cannot be pulled in automatically.- Pasting a full URL instead of the ID gives a broken embed.- A private or age restricted video will not play in the gallery, even though the tile appears.

## Troubleshooting

### The video does not play

Check the ID on its own line. A pasted *watch?v=* URL, a trailing *&t=* timestamp or a stray space all break the embed.

### The wrong thumbnail shows

The tile uses the **Image** you set on the item, so change it there.

## Related Docs

- [Video gallery](https://nexterwp.com/docs/create-wordpress-video-gallery/)- [Vimeo video gallery](https://nexterwp.com/docs/create-wordpress-vimeo-video-gallery/)- [Video carousel](https://nexterwp.com/docs/create-video-carousel-in-wordpress/)