Blog

How to Sync a YouTube Playlist with WordPress

Import a YouTube playlist into WordPress once and let new videos arrive on their own: set up an automatic import, choose the pace, and show the playlist as a self-updating gallery.

Video Hub Automatic import page with the importers, their progress and time estimates

A YouTube playlist is already a curated, ordered collection: a course, a podcast season, a product range, a weekly show. Copying each new video to your website by hand is the part nobody enjoys. When you sync a YouTube playlist with WordPress, every video added to the playlist shows up on your site as a post of its own, in the gallery you chose, without you doing anything after the first setup.

In short

To sync a YouTube playlist with WordPress, copy the playlist ID (the part after list= in its URL), create an automatic import of type YouTube playlist in Video Hub, choose the post type, category and post status, and add it to the import queue. Video Hub imports the existing videos in batches, then checks the playlist for new ones on a schedule. Show the playlist on a page with a Playlist block set to that category.

What “sync” means here

Syncing works in one direction, from YouTube to WordPress, and it is built for adding videos:

  • New videos added to the playlist become posts on your site at the pace you set.
  • The back catalog already in the playlist is imported first, a batch at a time, in the background.
  • Removed videos: if a video is deleted or made private on YouTube, the optional removed videos check unpublishes its post, so visitors never meet a broken player.
  • Your edits stay yours. Taking a video out of the playlist doesn’t delete its post, and changes on YouTube don’t overwrite your text. When you do want fresh data, the Update videos tool refreshes durations, views, thumbnails and, if you choose, titles and descriptions.

Before you start: find the playlist ID

Open the playlist on YouTube and look at the address bar. The playlist ID is everything after list=:

https://www.youtube.com/playlist?list=PLxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Playlist IDs usually start with PL. If what you want is every upload of a channel rather than one playlist, import the channel instead: see how to import a YouTube channel into WordPress. The Channel ID finder in Video Hub also reads playlist links and tells you which channel a playlist belongs to.

How to sync a YouTube playlist with WordPress, step by step

Step 1: Connect Video Hub to YouTube

Video Hub reads playlists through the YouTube Data API. Connect your Google account with OAuth (recommended) by following how to get a YouTube Client ID and Client Secret, or paste an API key if you only need public playlists: here is how to get a YouTube API key.

Step 2: Create an automatic import for the playlist

Go to Videos → Automatic import → Add new. Set Feed type to YouTube playlist, paste the playlist ID and click Check feed to confirm Video Hub can read it. You can also start from the Import videos page: load the playlist there, look through its videos, and create the automatic import from that screen.

Video Hub Edit feed screen with feed type, feed ID, import behavior options and the import estimate panel
An automatic import: feed type and ID, import behaviour, and the import estimate on the right.

Step 3: Choose where the videos go

In the Import as panel, pick the post type, the category, the author and the post status. Choose Published to put videos live straight away, or Draft or Pending review if an editor should check each one first. Give every synced playlist a category of its own: it becomes the source of the playlist gallery in step 6.

Step 4: Decide which videos to import

A few filters keep the sync focused:

  • Import if published after: skip older videos and start from a date.
  • Skip YouTube Shorts: leave out vertical or square videos up to 3 minutes long.
  • Video duration: import only videos between a minimum and maximum length.
  • Don’t import deleted videos again: a video you delete from your site stays deleted.

Step 5: Save it to the import queue

Keep Add to import queue checked and save. The import estimate tells you how long the rest of the playlist will take, or how often a finished playlist is checked for new videos. Tick When finished, import only new videos so that, once the back catalog is in, each check looks only at the newest entries.

Video Hub Automatic import list with a playlist importer that is up to date and a channel importer with progress and time left
The automatic import list: a playlist that is up to date and checks for new videos every few minutes, next to a big channel still importing.

Step 6: Show the playlist on a page

Add a Playlist block to any page, set Video Source to the category from step 3 and choose one of the six layouts. Every new video the sync imports into that category appears in the gallery on its own. The details are in the next section.

How often does the playlist sync?

The pace is a global setting in Videos → Settings → Import options: import from 1 to 50 videos every minute, every few hours or once a day. Automatic imports run in the background through Action Scheduler and take turns in a queue, so a busy channel can’t block your playlist forever and imports never slow down a visitor’s page.

Two options help with large playlists:

  • Import new videos right away starts a second process that checks the beginning of the playlist for fresh videos while the older ones are still importing. For playlists it works only when the playlist is sorted by Date added (newest) on YouTube.
  • Repeat import in queue lets one playlist run several times in a row before the next import takes its turn.

Imports run when your site gets visits. On a quiet site, or if your host disables WP-Cron, ask the host for a real server cron job so the schedule holds. The automatic import explained tutorial covers the queue in detail.

The Playlist block pulls videos either from a hand-picked list or from a video category. A synced playlist works best with the category source: the gallery always lists what the automatic import has brought in. In the block settings you can:

  • show every video in the category, or cap the number
  • sort newest first, oldest first, or by title, which suits numbered lessons
  • split long lists into pages, or add a “Load more” button with your own label
  • pick the layout: Default, Listy, Simple, Grid, Cinema or Minimal
Simple YouTube playlist theme in WordPress with a large player above a grid of video thumbnails
The Simple layout: a large player above the playlist’s thumbnails.

Category playlists use video categories, so import synced playlists into the Videos post type. Prefer shortcodes or Elementor? The same playlist is available as an Elementor widget and as a shortcode, for example [cbc_playlist category="12" theme="simple" order="date_asc"]. See all six playlist gallery layouts or browse them on the themes page.

Ideas: series, courses and channels

Playlists map neatly onto real-world content. Sync each one to its own category and gallery and you get a self-updating section for every topic:

  • Courses: one playlist per module, ordered oldest first, so lesson 1 always comes first.
  • Podcasts and shows: one playlist per season, with every episode on a page you can extend with notes.
  • Product ranges: demos and how-tos grouped by product, linked from the product pages.
  • Events and talks: one playlist per event, published as drafts so you can add speaker details.

More examples are on the use cases page.

A synced playlist works for SEO, too

Every synced video is an indexable post on your domain, not a player loaded by JavaScript. It has its own title, text, address and place in your sitemap, and it can carry video schema. The gallery gives visitors a tidy way to browse, while search engines get a steady stream of fresh pages. Read more about why video pages beat embeds and how to handle video SEO in WordPress.

Troubleshooting a playlist that doesn’t sync

  • Nothing imports: open the import’s activity log. It lists every run, every skipped video with the reason, and the last YouTube error.
  • Some videos are missing: check the filters (date, Shorts, duration) and whether the videos were imported before by another import. Unlisted videos are imported only when you allow them in the import options.
  • Private playlists: YouTube shows a private playlist only to the account that owns it. Make it public or unlisted to sync it.
  • Imports stop on a quiet site: set up a server cron job, as described above.
  • Quota errors: lower the pace or the number of videos per run; the quota resets every day.

Still stuck? The automatic import troubleshooting guide goes through each case.

Syncing YouTube playlists: FAQ

Does removing a video from the YouTube playlist delete it from WordPress?

No. The sync adds new videos; it doesn’t delete posts. If you take a video out of the playlist, its post stays on your site until you unpublish or delete it. Videos that are deleted or made private on YouTube are different: turn on the removed videos check and Video Hub unpublishes their posts.

How quickly do new playlist videos appear on my site?

It depends on the import pace you set (from every minute to once a day) and on how many automatic imports share the queue. The automatic import screen shows when each playlist is checked next. For a big playlist that is still importing its back catalog, “Import new videos right away” brings fresh videos in sooner.

Can I sync several playlists?

Yes. Create one automatic import per playlist. They take turns in the import queue, and each can have its own category, author, post status and filters.

Can I sync a playlist from a channel I don’t own?

Yes, as long as the playlist is public. Every video becomes a post on your site that plays the original YouTube video.

Will syncing a playlist use up my YouTube API quota?

Rarely. Each check is a small request, and Google gives every project 10,000 quota units a day for free. Video Hub shows today’s estimated quota use, and you can lower the pace if you run many imports.

Sync your playlists to WordPress

Set it up once and the playlist stays current. 30-day money-back guarantee.