Description
ChapterPlay automatically extracts chapters from YouTube video descriptions and displays them in a beautiful, interactive sidebar. Visitors can click any chapter to jump directly to that timestamp.
Key Features
- 🎬 Gutenberg Block — drag and drop into any post or page
- 🔖 Shortcode —
[chapterplay url="..."]for classic editor or any text widget - 📑 Auto Chapter Extraction — reads timestamps directly from YouTube descriptions
- 📺 Multiple Players — add unlimited players on the same page with no conflicts
- 🌙 Premium Dark Design — polished UI that adapts to any container size (300px to full-width)
- ⚡ Smart Caching — chapter data is cached server-side to reduce API calls
- 🔑 No API Key Required — uses YouTube’s internal data endpoint; zero configuration needed
How to Use
Gutenberg Block:
1. In the block editor, click + to add a new block
2. Search for ChapterPlay
3. Add the block, then paste the YouTube URL in the right-hand Settings panel
4. Save and preview — the player renders on the frontend with chapters
Shortcode:
[chapterplay url="https://www.youtube.com/watch?v=VIDEO_ID"]
[chapterplay url="VIDEO_ID"]
You can use the shortcode inside any page, post, or text widget.
External Services
This plugin connects to youtube.com to fetch video metadata (title, description, duration). No personal user data is transmitted. The connection is made server-side only when a video is first loaded or the cache expires.
- Service: YouTube (google.com)
- Data sent: YouTube video ID only
- Data received: Video title, author, duration, description
- Privacy policy: https://policies.google.com/privacy
- Terms of service: https://www.youtube.com/t/terms
Screenshots



Blocks
This plugin provides 1 block.
- ChapterPlay
Installation
- Upload the
chapterplayfolder to/wp-content/plugins/ - Go to Plugins Installed Plugins in your WordPress admin
- Click Activate next to ChapterPlay Chapter Player for YouTube
- Use the block or shortcode anywhere on your site — no further setup needed
FAQ
-
Do I need a YouTube API key?
-
No. ChapterPlay uses YouTube’s built-in data endpoint. No Google Cloud account or API key is required.
-
Why are no chapters showing?
-
Chapters are extracted from the video’s description. If the video description does not contain timestamps (e.g.
00:00 Introduction,01:30 Next Section), the player will show a “Full Video” entry instead. -
Can I add multiple players on the same page?
-
Yes! Each shortcode or block instance is fully independent. Add as many as you need — they will not interfere with each other.
-
Does the player work on mobile?
-
Yes. The layout is fully responsive and adapts from 300px to full-width containers.
-
Which YouTube URL formats are supported?
-
https://www.youtube.com/watch?v=VIDEO_IDhttps://youtu.be/VIDEO_IDhttps://www.youtube.com/shorts/VIDEO_ID- Plain 11-character Video ID
Reviews
There are no reviews for this plugin.
Contributors & Developers
“ChapterPlay Chapter Player for YouTube” is open source software. The following people have contributed to this plugin.
ContributorsTranslate “ChapterPlay Chapter Player for YouTube” into your language.
Interested in development?
Browse the code, check out the SVN repository, or subscribe to the development log by RSS.
Changelog
1.0.0
- Initial release
