Buoy Video Sync
Buoy Video Sync imports content from a YouTube channel into WordPress. Point it at a channel, choose what to sync and which post type to save it as, and Buoy Video Sync creates posts complete with titles, descriptions, thumbnails, view counts, and other YouTube metadata.
Every sync runs once, immediately after you save the rule — so you stay in control of when content is imported.
Features
- Sync from a YouTube channel
- Three sync actions: import new videos, import new playlists, or import the channel itself
- Save synced items as any post type you choose (Posts, or a custom post type)
- On-demand imports — each rule runs immediately when you save it, so you decide exactly when content is imported
- Quota estimation — see how many YouTube Data API units a sync will use before you run it
- Thumbnails shown as the featured image when none is set; channel profile pictures and banners are downloaded into your media library
- Sync history with the last-synced time and a per-rule error log
- Stores all YouTube data in standard post meta (
_buoyvs_*) for easy use in your theme or queries [buoy-video-sync]shortcode and three Gutenberg blocks (Field, Image, Embed) to display synced titles, descriptions, stats, thumbnails, and the YouTube player anywhere on your site — no code required- Delete channel — clear the configured channel and its sync history in one click when you want to start over or point at a different channel
- Optional «remove all data on uninstall» setting — your content stays unless you ask for it to be removed
Requires a Google API key with the YouTube Data API v3 enabled. Requests are made directly from your server to Google using your own key; no data passes through any third-party service.
Go further with Pro
Buoy Video Sync Pro adds power-user automation:
- Sync from unlimited YouTube channels
- Recurring schedules — hourly, daily, weekly, monthly, or a custom interval
- Update existing posts — refresh all metadata, or only the fields you choose
- Taxonomy assignment — file synced items into categories, tags, and custom taxonomy terms
- Field mapping — map YouTube fields (including each thumbnail size) to your own custom meta keys
- Filter conditions — sync only the items that match your rules
- Video protection — stop syncs from overwriting your manual edits
Learn more about Buoy Video Sync Pro
External services
Buoy Video Sync connects to the YouTube Data API v3, a service provided by Google, to fetch the public metadata it imports into WordPress.
What it is used for: retrieving public information about the YouTube channels, playlists, and videos you choose to sync — such as titles, descriptions, thumbnail URLs, view counts, publish dates, and channel/playlist/video IDs.
What data is sent and when: requests are made only when you save a channel, run a sync, or use the pre-sync quota estimate. Each request is sent directly from your own server to Google’s API endpoint (https://www.googleapis.com/youtube/v3/) and includes the Google API key you provide and the channel, playlist, or video identifier being synced. No personal data about your site’s visitors or users is sent, and no data passes through any service operated by the plugin author or a third party.
Images: channel profile pictures and banners are downloaded from the URLs the YouTube Data API returns and stored locally in your media library. Video and playlist thumbnail URLs returned by the API point to YouTube’s own image host (i.ytimg.com) and are stored and referenced as-is, in the same way YouTube serves them — the plugin does not host, offload, or proxy any images from its author’s servers.
Video player: the optional Embed block and the [buoy-video-sync type="embed"] shortcode display YouTube’s own embedded player in an iframe pointed at https://www.youtube.com/embed/, the same way pasting a YouTube link into the block editor does via WordPress’s built-in oEmbed support. No plugin code or data is involved in loading the player — the visitor’s browser requests it directly from YouTube.
This service is provided by Google. By using it you agree to Google’s terms and privacy policy:
- YouTube API Services Terms of Service: https://developers.google.com/youtube/terms/api-services-terms-of-service
- Google Privacy Policy: https://policies.google.com/privacy
Using synced data on your site
Every synced video, playlist, and channel is a regular WordPress post, so you can already query and template it however you like. For everyone else, the [buoy-video-sync] shortcode and three Gutenberg blocks put the same data on the page without writing any code.
Shortcode
[buoy-video-sync id="123" field="title"]
[buoy-video-sync id="123" field="view_count"]
[buoy-video-sync id="123" field="thumbnail" size="maxres"]
[buoy-video-sync id="123" type="embed"]
id is the post ID of the synced video, playlist, or channel post. Available `field` values depend on the post: `title`, `description`, and, for videos, `video_url`, `published_date`, `duration`, `view_count`, `like_count`, `comment_count`; for playlists, `playlist_video_count`; for channels, `subscriber_count`, `video_count`. Image fields are `thumbnail` (video), `playlist_thumbnail`, `profile_photo`, and `banner_image` (channel).
Gutenberg blocks
Add a Video Sync Field, Video Sync Image, or Video Sync Embed block from the block inserter (search «Video Sync»). Each block reads from the post it’s placed on by default — drop an Embed block into a synced video post’s content and it plays that video — or pick a different post from the block’s settings panel.
For Developers
Buoy Video Sync fires action hooks after each item’s metadata is saved, so you can run your own code whenever a video, playlist, or channel is synced. Each hook fires on both the initial import and every re-sync, after all metadata has been written. The synced data is passed to the hook, so you can identify or filter items without making another API call.
buoyvs_video_synced
Fires after a video’s metadata is saved.
do_action( 'buoyvs_video_synced', int $post_id, array $video_data, string $source_type, int $source_id );
$post_id— the video post ID.$video_data— video data from the YouTube Data API (title, description, view_count, like_count, comment_count, video_id, and more).$source_type— how it was synced:channel,playlist, orvideo.$source_id— the source term ID the video was synced from.
buoyvs_playlist_synced
Fires after a playlist’s metadata is saved.
do_action( 'buoyvs_playlist_synced', int $post_id, array $playlist_data, string $channel_id );
$post_id— the playlist post ID.$playlist_data— playlist data from the YouTube Data API.$channel_id— the source channel ID the playlist belongs to.
buoyvs_channel_synced
Fires after a channel’s metadata is saved.
do_action( 'buoyvs_channel_synced', int $post_id, array $channel_data, string $channel_id );
$post_id— the channel post ID.$channel_data— channel data from the YouTube Data API.$channel_id— the YouTube channel ID.
Example
add_action( 'buoyvs_video_synced', function ( $post_id, $video_data ) {
// Runs each time a video is synced.
error_log( sprintf( 'Synced video %d (%s)', $post_id, $video_data['video_id'] ?? '' ) );
}, 10, 2 );
buoyvs_metabox_tabs
Add your own tab to the video, playlist, or channel metabox on the post edit screen. Return an array of tabs, each with a slug, a label, and a render callback that echoes the panel’s content.
apply_filters( 'buoyvs_metabox_tabs', array $tabs, string $type, int $post_id );
$tabs— list of tabs to add. Each:[ 'slug' => string, 'label' => string, 'render' => callable( int $post_id ) ].$type— which metabox is rendering:video,playlist, orchannel.$post_id— the current post ID.
Example — add a tab only to the video metabox:
add_filter( 'buoyvs_metabox_tabs', function ( $tabs, $type, $post_id ) {
if ( 'video' !== $type ) {
return $tabs;
}
$tabs[] = array(
'slug' => 'my_tab',
'label' => 'My Tab',
'render' => function ( $post_id ) {
echo '<p>Custom content for post ' . (int) $post_id . '</p>';
},
);
return $tabs;
}, 10, 3 );