Description
SDAweb Channels for YouTube turns any public YouTube channel into a fast, privacy-friendly video section on your WordPress site. Add channels by pasting their URL, pick a layout, and drop a shortcode or the block into any page. Videos are fetched in the background and stored in your own database, so visitors never trigger a YouTube API call and pages load instantly.
Built and maintained by SDAweb for church, school and community sites that stream regularly, which is why live and upcoming broadcasts are a first-class feature rather than an afterthought.
Why site owners pick it
- Set up in five minutes – paste a channel URL, handle or ID; the plugin finds the rest.
- Looks right everywhere – responsive grids, channel tabs and sliders that adapt to phones, tablets and the width of the column they sit in.
- Live streams just work – live and upcoming broadcasts are detected automatically, shown with badges, viewer counts and countdowns, and kept out of the regular lists.
- Fast and private – all data is cached locally, thumbnails load lazily, and the player only loads from YouTube’s privacy-enhanced domain when a visitor presses play.
- Yours to style – colours, badge and button styles, every visitor-facing text and a set of CSS variables for dark themes.
- Free to run – a typical site with ten channels uses a few hundred of the 10,000 free daily YouTube API units.
Layouts and playback
- Grid – responsive multi-column grid (1–6 columns) that follows the width of its container.
- Tabs – one tab per channel, with three navigation styles: scrolling tabs, wrapping pills or an avatar strip. Fully keyboard-accessible.
- Slider – horizontal carousel with arrows, scroll-snap and keyboard support.
- Auto player (default) – lightbox on desktop and tablet, inline on phones.
- Lightbox – fullscreen overlay with previous/next, arrow keys, Escape, swipe gestures and a mobile bottom sheet.
- Inline – plays inside the card, with an expand-to-lightbox button.
- Link – opens the video on YouTube in a new tab.
- Load More – show a first batch and let visitors load the rest without a page reload.
- Hide Shorts –
exclude_shorts="true"removes YouTube Shorts from any list; the block and the Shortcode Builder have the same switch.
Live and upcoming streams
- Automatic detection of live broadcasts and scheduled streams, checked every 5 minutes.
- Broadcast Boost – a weekly time window (for example Saturday 10:30–13:00) during which the plugin checks every minute.
- Live badge with viewer count, upcoming badge with countdown, “Starting soon” once the time has passed.
- Zero-quota RSS discovery catches streams that were scheduled at the last minute.
- Stale guard: an upcoming stream drops off one hour after its start time if it never went live; a live stream after 24 hours.
[sdawchfo_live]shows only live and upcoming streams, with “Live now” and “Coming up” headings and a friendly empty state.
Channel management
- Add channels by URL (
youtube.com/@handle,/channel/UC…,/user/name), by handle or by channel ID. - Drag-and-drop ordering controls tab and section order site-wide; override it per page with the
idsattribute. - Custom labels per channel.
- Scheduled refresh every 1–24 hours (you choose), manual refresh per channel or for all, automatic cleanup of deleted and private videos, daily refresh of channel name, avatar and subscriber count.
- A health card on the Dashboard tells you when YouTube last answered and explains any error in plain language (for example “quota used up, resets at midnight Pacific time”). The same check appears under Tools → Site Health.
- Export and import channels and settings as a JSON file.
Shortcodes
[sdawchfo_channel id="UC…"]– videos from one channel (byid,handleorlabel).[sdawchfo_channels]– several channels in a grid, tabs or slider.[sdawchfo_feed]– one combined list of the newest or most-viewed videos across channels.[sdawchfo_live]– live and upcoming streams only.
Common attributes for the first three: count, columns, layout, sort, player, pagination, per_page, show_stats, show_duration, show_channel, show_description, exclude_shorts, live_only and (for multi-channel shortcodes) ids. The live shortcode takes ids, count, columns, player, show_channel, show_stats, show_duration, show_description and empty_message. The Shortcode Builder on the Dashboard writes them for you, and the Settings page has a full reference table with examples.
Block editor
The YouTube Channel block offers the same choices as the shortcodes – channel selection, layout, columns, count, sort, player, pagination, Live Only, Show Description and Exclude Shorts – with a styled live preview in the editor.
Customisation
- 29 visitor-facing texts (buttons, badges, headings, screen-reader announcements) editable in Settings, in any language.
- Colours and styles for the play button, Load More button, live and upcoming badges, active tab and time texts, with colour pickers.
- CSS variables for themes:
--sdawchfo-card-bg,--sdawchfo-surface,--sdawchfo-surface-alt,--sdawchfo-text,--sdawchfo-muted,--sdawchfo-border,--sdawchfo-accent. - Developer hooks to change queries, card classes, thumbnail URLs, generated CSS and the REST payload, plus actions before and after a refresh and when a refresh fails. See
docs/hooks.mdin the plugin folder. - Public REST endpoints for custom or headless front ends.
Privacy and performance
- Visitor page views make no request to Google: everything is served from the local cache.
- The plugin sets no cookies and sends no visitor data anywhere.
- Thumbnails are loaded from YouTube’s image servers (i.ytimg.com) with native lazy loading and responsive sizes; the player (youtube-nocookie.com) loads only when a visitor presses play.
- A suggested privacy-policy text is provided under Settings → Privacy.
- Works with page caches (WP Rocket, LiteSpeed, Cloudflare) and object caches (Redis, Memcached).
Third-Party Services
YouTube Data API v3
This plugin connects to the YouTube Data API v3 to fetch channel information and video data. API calls are made server-side only when:
- An admin adds, refreshes or tests a channel or the API key
- The scheduled cron refresh runs (configurable interval, default 6 hours)
- The live status cron runs (every 5 minutes, or every 1 minute during a configured Broadcast Boost window)
No API calls are made during normal visitor page views — all data is served from the local cache.
- Service provider: Google LLC
- API endpoint:
https://www.googleapis.com/youtube/v3 - YouTube API Terms of Service
- Google Privacy Policy
A YouTube Data API v3 key is required. You can obtain one for free from the Google Cloud Console; the Settings page walks you through it.
YouTube RSS Feeds
This plugin fetches public YouTube RSS feeds (https://www.youtube.com/feeds/videos.xml) to discover recently published and scheduled videos. These requests are read-only, use no API quota, and contain only publicly available video IDs.
- Service provider: Google LLC (YouTube)
- YouTube Terms of Service
- Google Privacy Policy
YouTube Thumbnails and Embeds
Video thumbnails are loaded in the visitor’s browser from YouTube’s image servers (i.ytimg.com) when a page containing the plugin is shown. When a visitor clicks play, an iframe loads from YouTube’s privacy-enhanced domain (youtube-nocookie.com). No embed loads until the visitor initiates playback.
- Service provider: Google LLC (YouTube)
- YouTube Terms of Service
- Google Privacy Policy
Bundled library
The colour pickers in the settings use wp-color-picker-alpha (GPL-2.0-or-later). The unminified source is available at that address.
Installation
- Upload the
sdaweb-channels-for-youtubefolder to/wp-content/plugins/, or install it from Plugins → Add New. - Activate the plugin through the Plugins menu.
- Go to YouTube Channels → Settings, paste your YouTube Data API v3 key and click Test Connection. The page includes a step-by-step guide for getting a free key.
- Go to YouTube Channels → Channels and add your first channel by URL, handle or ID.
- Use the Shortcode Builder on the Dashboard, or insert the YouTube Channel block in the editor.
FAQ
Where do I get a YouTube API key, and is it free?
From the Google Cloud Console: create a project, enable the YouTube Data API v3 and create an API key. It is free: Google gives every project 10,000 quota units per day. The Settings page has a step-by-step guide with the exact URL pattern to restrict the key to your site.
How much of the quota does the plugin use?
A site with one channel uses about 300 units a day, almost all of it for the 5-minute live check. Ten channels on the default 6-hour refresh use roughly 400 units. Broadcast Boost adds about 150 units per channel for every hour it is active. Visitors never use quota. The Dashboard shows the state of the connection, and if the quota is ever used up, cached videos keep showing until Google resets the quota at midnight Pacific time.
How do I hide YouTube Shorts?
Add exclude_shorts="true" to the shortcode, for example [sdawchfo_feed exclude_shorts="true"], switch on Exclude Shorts in the block, or tick the box in the Shortcode Builder. Shorts are recognised from the channel’s own Shorts list, so Shorts up to three minutes long are caught too. To hide them site-wide without editing shortcodes, add this to your theme’s functions.php:
add_filter( 'sdawchfo_video_query_args', function( $args ) { $args['exclude_shorts'] = true; return $args; } );
How often are videos refreshed?
By default every 6 hours; choose anything from 1 to 24 hours in Settings. Live status is checked every 5 minutes. Channel name, avatar and subscriber count are refreshed once a day. Use Refresh or Refresh All on the Channels page to update immediately.
My videos are not updating. What should I check?
- Open YouTube Channels → Dashboard: the YouTube API card tells you whether the last request succeeded and, if not, why (invalid key, quota, website restriction).
- Check the Status column on the Channels page for a per-channel error.
- WordPress runs scheduled jobs only when someone visits the site. On a quiet site set up a real server cron (see the next question). Tools → Site Health also reports when one of the plugin’s scheduled jobs is missing.
How do I set up a real server cron?
Add define('DISABLE_WP_CRON', true); to wp-config.php and create a cron job on your server that calls https://yoursite.com/wp-cron.php?doing_wp_cron every minute. The Settings page shows the exact command for your site. This is strongly recommended if you use Broadcast Boost.
How does live-stream detection work?
Every 5 minutes the plugin asks YouTube about the videos that could be live: known live or upcoming streams, recent uploads, and anything new in the channel’s RSS feed (which costs no quota). Live streams get a red LIVE badge with the viewer count; scheduled streams get a blue UPCOMING badge with a countdown. They are automatically excluded from the normal shortcodes and shown by [sdawchfo_live] or live_only="true".
What is Broadcast Boost?
A weekly time window during which the live check runs every minute instead of every 5, so a stream that starts at 10:30 appears on your site within a minute. Set the day and the time range in Settings. Outside the window the normal 5-minute check continues.
Which player should I choose?
Auto (default) opens a lightbox on desktop and tablet and plays inline on phones; good for most sites. Lightbox always uses the overlay with previous/next navigation. Inline always plays inside the card and offers an expand button. Link sends visitors to YouTube in a new tab. Set it per shortcode or block.
Does it work with caching plugins?
Yes. Page caches (WP Rocket, LiteSpeed Cache, Cloudflare, host caches) serve the plugin’s HTML like any other content, and Load More keeps working on cached pages. Object caches (Redis, Memcached) are supported; the plugin’s own caches are invalidated correctly when videos or settings change.
How do I control the order of tabs and sections?
Drag channels into the order you want on the Channels page; that order is used everywhere. For a different order on one page, list channel IDs in the shortcode: [sdawchfo_channels layout="tabs" ids="UCabc,UCxyz"].
Can I show more than 50 videos?
Yes, up to 100 per channel with count="100". Combine it with pagination="loadmore" and per_page to show a first batch and load the rest on demand.
Can I adapt the look to a dark theme?
Set the CSS variables on your body or theme wrapper, for example --sdawchfo-card-bg: #1e1e1e; --sdawchfo-surface: #1e1e1e; --sdawchfo-text: #f3f3f3; --sdawchfo-muted: #b0b0b0; --sdawchfo-border: #333;. Badge, button and tab colours have their own settings under Settings → Appearance.
Can I change the texts shown to visitors?
Yes. Settings → Frontend Labels lets you edit all 29 texts, from the Load More button to the screen-reader announcements, in any language and without translation files.
What happens to deleted or private videos?
They are removed from your site at the next refresh of that channel. If YouTube ever answers with something that is not video data, the plugin keeps the cache instead of emptying it and shows the error on the Channels page.
Can I move my setup to another site?
Yes. Settings → Import / Export downloads a JSON file with channels and settings (the API key is not included). Import it on the other site and run Refresh All.
Is my API key visible to visitors?
No. The key is used only on your server and is never sent to the browser. Since 1.6.0 it is not even printed into the settings page; the field shows a masked hint instead.
Videos do not play in Vivaldi or Brave. Why?
The plugin uses YouTube’s privacy-enhanced domain (youtube-nocookie.com) and no tracking scripts, which satisfies most blockers. If a video still does not play, the browser’s own blocker is stopping the YouTube player itself; allow it for your site via the shield icon.
Screenshots






Changelog
The most recent releases are listed here. The complete history is in changelog.txt in the plugin folder.
1.6.0
- New: Hide YouTube Shorts with
exclude_shorts="true"on[sdawchfo_channel],[sdawchfo_channels]and[sdawchfo_feed], an “Exclude Shorts” switch in the block and a checkbox in the Shortcode Builder. Requested on the support forum. - New: The Dashboard shows the health of the YouTube connection (last successful call, last error explained in plain language), the plugin’s own screens warn when the API has started failing, and Tools → Site Health gets a test and an info section.
- New: Three more editable visitor texts: the screen-reader announcement after Load More and the Mute/Unmute button labels (they stayed English on translated sites), plus the “Watch on YouTube” link label.
- New: Settings and Channels links on the Plugins screen; CSS variables for dark themes; a
sdawchfo_refresh_channel_failedaction for developers. - Improved: Live detection on sites with more than three channels — the live check silently dropped the RSS data of the fourth channel onwards; it now skips videos that cannot change any more and asks YouTube about the rest in batches.
- Improved: Cache invalidation now works with Redis and Memcached object caches (new videos and settings changes used to stay invisible there for up to five minutes), and the live check no longer empties the rendering cache every five minutes when nothing changed.
- Improved: Channel name, avatar and subscriber count are refreshed once a day by the scheduled job, and a new upload discovered by the live check gets its Shorts flag from the channel’s Shorts list right away.
- Improved: Thumbnails use native lazy loading with responsive sizes and priority for the first card; they now show without JavaScript and in the block editor preview. Grid columns follow the width of their container, not only the screen.
- Improved: Block editor — styled, non-clickable preview; “Layout” has a “Site default” choice so the Default Layout setting applies to blocks; video count up to 100 with reset; “Show Description” and “Exclude Shorts” toggles.
- Improved: Shortcode Builder — correct defaults per shortcode type (the live shortcode no longer gets attributes it ignores), uses the permanent channel id instead of the handle, new “Show description” and “Exclude Shorts” boxes, translatable descriptions.
- Improved: Accessibility — tabs follow the keyboard pattern (arrow keys, Home/End), the lightbox is named after the current video, script-driven scrolling respects “reduce motion”, inline players have a title.
- Improved: Play links carry the real YouTube URL, so Ctrl/Cmd-click, middle-click and “open in new tab” work and the video is reachable without JavaScript. Editors see a note when a shortcode names a channel that does not exist.
- Improved: The API key is no longer printed into the settings page; the field shows a masked hint. Leave it empty to keep the key or tick “Remove the saved key”.
- Fix: “Hide play button” survived an export/import; Broadcast Boost settings are exported too; colour and label changes saved for the very first time took up to a day to appear; the “Channel Name Truncation” row was visible when it should be hidden.
- Fix:
count="0"orper_page="0"no longer break a feed; import on hosts without direct filesystem access gives a clear message; Broadcast Boost refuses impossible times; Dashboard “Last refresh” times are read as UTC like the Channels list. - Fix: Legacy
youtube.com/user/NAMEURLs are looked up by username,/c/URLs get a clear hint, handles with non-Latin letters are accepted; counts round correctly (999,950 showed as “1000K”) and use the site’s decimal separator; screen readers hear the number of videos actually added. - Fix: Multisite — network activation sets up every site and uninstall cleans every site; a failing YouTube RSS feed is not retried for five minutes; a channel’s error message is cleared after a successful refresh; status words are translatable.
- Removed: the unused “refresh all” AJAX handler and the YouTube player part of API requests.
- Note: Blocks that used the default Grid layout now follow the Default Layout setting; if that setting is Tabs or Slider, set the block’s Layout to Grid explicitly to keep the old look.
1.5.21
- Fix: On phones, the round close button in the lightbox sat partly above and outside the video frame, on the dark sheet background, so it looked cut off. It now sits fully inside the top-right corner of the video. Desktop and tablet are unchanged.
- Fix: On small phones held in landscape, the same close button was pushed above the top of the screen and could not be tapped. It now stays inside the video frame there too.
1.5.20
- Fix: The two scheduled jobs that fetch new videos and check for live streams were only set up when the plugin was activated. If they went missing — after cloning or migrating a site, after a cron clean-up tool, or on a multisite network where activation ran for one site only — the site silently stopped getting new videos until the plugin was deactivated and activated again. The plugin now puts missing jobs back when it is updated and when an administrator opens the dashboard. On a site where the jobs exist, nothing changes.
- Fix: The “Auto” player was described the wrong way round in the plugin description, on the Overview screen and in the Shortcode Builder. What it does — and has always done — is open a lightbox on desktop and tablet and play inline on mobile phones. Only the texts changed.
- Accessibility: In the lightbox, Tab and Shift+Tab could leave the dialog and move into the page behind it on the first video, on the last video, and whenever the list has a single video. Keyboard focus now stays inside the lightbox.
- Accessibility: The slider now shows a focus ring when it has keyboard focus, and the expand, close and mute buttons — visible only on mouse hover — are now also shown when they have keyboard focus. Nothing changes for mouse and touch.
- The complete version history has moved to changelog.txt in the plugin folder; this section lists the most recent releases.
1.5.19
- Fix: If YouTube (or a proxy in front of it) answered a refresh with something that was technically successful but not video data — an error page, an empty or cut-off response — the plugin read it as “this channel has no videos any more” and deleted every cached video of the channel, leaving an empty feed until the next good refresh. Such an answer is now treated as a failed refresh: the cached videos stay, the channel shows the error on the Channels page and is tried again later. The same applies when YouTube lists a channel’s videos but returns details for none of them. Videos that are removed or made private are still cleaned up individually as before.
- Fix: “Test API key” no longer reports success for an answer that is not YouTube data.
- Fix: Videos added by “Load More” ignored the feed’s display settings and were always rendered with the lightbox player, statistics and duration on, and no description. With player=”link” the added videos did nothing when clicked (they tried to open a lightbox that is not on the page); with “auto” they behaved differently on phones from the videos above them; show_stats, show_duration, show_channel and show_description were ignored. Added videos now look and behave like the rest of the feed. Pages served from a page cache keep working as before until the cache is refreshed.
