How to Build a YouTube Gallery

A YouTube gallery pulls videos from a connected YouTube channel into a WordPress gallery. You build it in the Gallery Builder by selecting the YouTube source, picking a channel, setting filters, and choosing a layout. YouTube galleries are a Pro feature and require an active YouTube connection.

Before You Start

Connect your YouTube channel before creating the gallery. See the guide to connect a social account if you have not done this yet.

• WP Social Media Gallery Pro installed and activated.
• An active YouTube connection in the Source tab.
• YouTube source enabled in Settings > Source.

Create a New YouTube Gallery

1. Go to WP Social Media Gallery > Gallery Builder.
2. Click Create New Gallery.
3. Enter a title.
4. Confirm the gallery type is set to YouTube.

The builder opens on the Source step. If YouTube is not enabled, the step shows a Premium Feature lock screen.

Pick a Channel and Video Type

The YouTube source step has two menus: Accounts and Filters. In Accounts, pick the YouTube channel you want to pull videos from. In Filters, choose the video type and date range.

1. Click Accounts in the YouTube side menu.
2. Select your connected YouTube channel from the dropdown.
3. Click Filters in the side menu.
4. Under Select File Type, pick All Files, Image, Audio, or Video.
5. Set Maximum Limit to the number of videos to fetch.
6. Set Select Sorting to a date range or custom date.

The plugin fetches the videos automatically after you set the filters. Selected videos appear as thumbnails in the Files Container.

Choose Layout and Save

After the videos load, go to the Configuration step to pick a layout and adjust columns, spacing, and border radius. Then click Save Changes to store the gallery.

1. Click Configuration in the builder stepper.
2. Pick a view style: Automatic, Grid, Masonry, or Mosaic.
3. Set columns, spacing, and radius for each device.
4. Click Save Changes.

The gallery is saved to the wp_ccpwpsmg_galleries table and assigned an ID. You can reopen it any time from the Gallery Builder list.

What to Check

Confirm the YouTube gallery works correctly after saving.

• The Files Container shows YouTube video thumbnails.
• The chosen layout renders correctly on the front end.
• The gallery refreshes when you click Save Changes with new filters.

Troubleshooting

If the YouTube gallery does not load videos, check the following.

• No files loaded: Confirm the YouTube connection is active in Settings > Source. An expired token returns no videos.
• Empty file type: Verify the selected file type matches the media in your YouTube channel.
• Token expired: Click Refresh on the YouTube connection card in Settings > Source.

Next Steps

With your YouTube gallery live, embed it using the shortcode or Gutenberg block. See the WordPress gallery block guide to add it to a page, or copy the shortcode from the embed panel.