---
title: "KISS YouTube Gallery: YouTube channel gallery for WordPress"
description: "KISS YouTube Gallery shows a YouTube channel, playlist or hand-picked set on WordPress: cached server-side, click-to-play, Shorts included, styled by your theme."
url: https://imaginarytrout.com/plugins/kiss-youtube/
---

KISS YouTube Gallery

# Your YouTube channel, on your own site.

Enter a channel handle and every public upload appears, newest first. New videos show up on their own. There is no video post type to keep up, because the videos stay on YouTube.

[Ask about KISS YouTube Gallery](https://imaginarytrout.com/contact/)See it running

Version

1.1.0

WordPress

6.4+

Tested up to

WordPress 7.1.4

PHP

8.0+

Releases

29

License

GPL 2.0 or later

## What it solves

Most YouTube galleries either load the player for every video, which is slow, or ask someone to copy each new video into WordPress by hand, which stops happening after a month.

KISS YouTube Gallery reads the channel through the YouTube Data API on the server, caches it, and shows a poster with a play button until someone clicks. Titles and thumbnails can be fixed per video without freezing the channel.

## What it does

- ### Any source

    A channel handle, channel URL or ID, a playlist, or a list of video IDs. A channel needs no playlist.

- ### Three layouts

    Showcase (a featured player with an up-next list), grid or masonry.

- ### Click to play

    Only the poster loads with the page; the player is created on click, from youtube-nocookie.com by default.

- ### Per-video overrides

    Custom title, description, poster, pin, position or hide, kept through every cache refresh.

- ### Shorts included

    A Shorts row under the long videos, or Videos and Shorts tabs in one widget.

- ### Video structured data

    Every video is described to search engines as a VideoObject, so it can appear in video results.

- ### Caching that never goes empty

    A last good copy is served whenever the API fails, and a scheduled warm-up means no visitor waits for YouTube.

- ### Your theme's look

    Structure from the plugin, style from the theme and the Elementor kit. No fonts or colors forced on you.

## What it needs

- WordPress 6.4 or later
- PHP 8.0 or later
- A YouTube Data API v3 key
- Elementor is optional

## See it running

The All Power Marine video gallery runs on it, with Videos and Shorts tabs.

- [All Power Marine, Our work (opens in a new tab)](https://marineboatlifts.com/our-work/)

## Install

1. ### Step 1

    Upload kiss-youtube-v<version>.zip via Plugins → Add New → Upload Plugin and activate.

2. ### Step 2

    Get a YouTube Data API v3 key (KISS YouTube → Help walks through Google Cloud Console). Either define KISS\_YT\_API\_KEY in wp-config.php (recommended) or paste it under KISS YouTube → Settings.

3. ### Step 3

    Under Settings, enter the source — for a channel, just its handle, e.g. @allpowermarine.

4. ### Step 4

    Drop the KISS YouTube Gallery widget onto an Elementor page, or add \[kiss\_youtube\] anywhere.

5. ### Step 5

    Fix a title or a thumbnail under KISS YouTube → Videos. See Help for the CSS variable reference.

New versions install the same way: upload the new ZIP over the old one. Settings are kept.

## Changelog

29 releases so far. The newest:

1. ### 1.1.0November 15, 2026

    - **Added** Updates itself. New versions now arrive in Dashboard › Updates like any plugin from wordpress.org, with one-click and automatic updates, served from imaginarytrout.com. Nothing to set up.
    - **Added** A red "Update to v…" badge beside the version on the plugin's own screens whenever a newer version is waiting. It links to Dashboard › Updates.
    - **Added** The plugin's icon in the admin menu and beside each screen title, and its icon and banner on the update screen.
    - **Added** Marked compatible with WordPress 7.1.4 ("Tested up to"), so the update screen no longer says "Not tested".
    - **Security** The update check is a read-only HTTPS request to imaginarytrout.com, made from wp-admin and WordPress's scheduled update check, never from a visitor's page.
2. ### 1.0.0October 27, 2026

    - **Added** Video structured data (schema, on by default; Settings › Metadata › Search engines, with the per-widget override under Metadata).
    - **Security** The JSON-LD block is built with wp\_json\_encode() and JSON\_HEX\_TAG / JSON\_HEX\_AMP, so no text from the API or an override can close the script element; tags are stripped from every value, and only i.ytimg.com and Media Library URLs are used as thumbnails.
3. ### 0.15.0September 19, 2026

    - **Added** After the last video, a swipe (swipe\_end; global setting with the per-widget override under Playback, showcase with touch gestures).
    - **Fixed** Touch gestures, showcase: a swipe on the poster itself did nothing — only the text beneath moved the video.
4. ### 0.14.1September 19, 2026

    - **Fixed** Touch gestures, showcase: swiping the featured video walks every up-next video in order.
    - **Changed** Touch gestures, showcase: the featured poster is now a native sideways snap scroller of every poster in the widget, one per screen — the same mechanism as the Shorts row, so it moves like it.
5. ### 0.14.0September 19, 2026

    - **Added** Shorts lightbox (shorts\_open: lightbox on phones and tablets by default, everywhere, or inline).
6. ### 0.13.3September 19, 2026

    - **Changed** A swipe now lands on the next video's poster and waits for a tap.

## KISS YouTube Gallery questions

### 

No. Every channel has an automatic uploads playlist; enter the handle and it is used.

### 

Yes, on the next cache refresh (six hours by default, or press Refresh now), at the top, with no admin action — unless a Video Set is selected, which is the deliberate way to curate a fixed list.

### 

No. Overrides are stored separately from the cached payload and keyed by video ID, so a refresh can never clobber them. A blank override means "use YouTube's".

### 

No. The shortcode works on any theme. With Elementor active you also get the widget, and the gallery reads the Kit's global colours and typography automatically.

### 

Preferably define( 'KISS\_YT\_API\_KEY', '…' ); in wp-config.php. The constant always wins over the stored option. Restrict the key in Google Cloud Console to the YouTube Data API v3 and to your server's IP — the Help page explains.

### 

A full refresh of a five-video channel costs 2 units of the default 10,000 per day. Rendering a page costs nothing.

### 

Re-point the CSS variables from your own stylesheet with the two-class selector, .elementor-widget-kiss\_youtube .kiss-youtube { --kiss-yt-…: …; }, which beats the plugin regardless of load order. The Help screen lists every variable and what it falls back to.

## Other KISS plugins

- [KISS Flickr Gallery](https://imaginarytrout.com/plugins/kiss-flickr/)
- [KISS CoverFlow Slider](https://imaginarytrout.com/plugins/kiss-coverflow/)
- [All plugins](https://imaginarytrout.com/plugins/)

## Want KISS YouTube Gallery on your site?

It is not on WordPress.org yet. It runs on the sites we build and manage. Tell us about yours, or about a plugin you need built.

[Start a project](https://imaginarytrout.com/contact/)

![](/brand/logos/trout-sticker.svg)

---

Imaginary Trout, Laramie, Wyoming. Start a project: https://imaginarytrout.com/contact/ · hello@imaginarytrout.com · 480-463-4202 (leave a message)
