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.
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.
- Open the Content panel and click + Add Item for each video.
- Set Source to YouTube.
- Paste the video ID into YouTube ID. Use the ID on its own, not the whole URL.
- Add a Title and a thumbnail Image, set your Layout and Columns, then publish.
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.
