Plugin Directory

YouTube Block – A better way to embed YouTube videos and speed up your site

YouTube Block – A better way to embed YouTube videos and speed up your site


The default embed block for Youtube videos sucks. It slows down your site. The more videos on the page the more it slow. This single-block plugin fixes that.

Why this block is better than the default one:

  • Instead of loading the entire iframe, only the video thumbnail is loaded, resulting in significant performance improvements
  • Ability to use a custom image as the video thumbnail
  • Ability to set a custom aspect ratio value for the video
  • Automatically load the video title as the caption
  • The same UI as the default core/embed, and you can use the video title as the caption of the block with one click
  • It can be transformed from/to the core embed block.
  • Automatically convert all default core embed YouTube blocks to this block with one line of code.

This plugin also provides a PHP API for developers to render a YouTube video URL as this block; or to automatically transform core/embed YouTube videos into this block.

The simplest example is:

    better_youtube_embed_block_render_block( ['url' => 'https://youtu.be/paSXmpHU9K4'] );

The example with all the parameters is:

        'url'               => 'https://youtu.be/paSXmpHU9K4',
        'aspectRatio'       => '16/9',
        'isMaxResThumbnail' => false,
        'caption'           => 'My awesome video',
        'customThumbnail'   => 'https://example.com/bg.jpg',
        'echo'              => false,

To automatically transform all core/embed YouTube videos on your site to this block, you need to put the following code into your wp-config.php or in your theme, plugin:

    define('BYEB_SPEED_UP_YOUTUBE_VIDEOS', true);


    add_filter( 'byeb_speed_up_youtube_videos', '__return_true' );

Please check out this page to see how fast it helps. The page contains around 30 embedded Youtube videos but they don’t slow down the page.

If this plugin is useful for you, please do a quick review and rate it on WordPress.org to help us spread the word. I would very much appreciate it.

Please check out my other plugins if you’re interested:

  • Content Blocks Builder – A tool to create blocks, patterns or variations easily for your site directly on the Block Editor.
  • Meta Field Block – A block to display a meta field or an ACF field as a block. It can also be used in the Query Loop block.
  • Block Enhancements – A plugin to add more useful features to blocks like icons, box-shadow, transform, hover style etc.
  • Icon Separator – A tiny block just like the core/separator block but with the ability to add an icon to it.
  • SVG Block – A block to insert inline SVG images easily and safely. It also bundles with more than 3000 icons and some common non-rectangular dividers.
  • Counting Number Block – A block to display a number that has the number-counting effect.
  • Breadcrumb Block – A simple breadcrumb trail block that supports JSON-LD structured data.

The plugin is developed using @wordpress/create-block.


這個外掛提供 1 個可供 Gutenberg/區塊編輯器使用的區塊。

  • YouTube Block – A better way to embed YouTube videos and speed up your site Embed YouTube videos without slowing down your site.


  1. Upload the plugin files to the /wp-content/plugins/better-youtube-embed-block directory, or install the plugin through the WordPress plugins screen directly.
  2. Activate the plugin through the ‘Plugins’ screen in WordPress


What problem does this plugin solve?

It provides a better solution to embed YouTube videos than the default one.

Who needs this plugin?

Anyone can use this plugin.


2024 年 6 月 10 日 4 則留言
Improves our rating with google pagespeed.web.devThat embed link on a homepage is the kiss of death for mobile speed rating. This plugin fixes thatThe only improvement might be if you could select what thumbnail to use so it doesn’t have to retrieve it outside the site (or if I could figure out why it isn’t caching it)
2024 年 3 月 14 日 1 則留言
I have been trying for weeks now with different plugins and different settings to speed up my website where I have added videos to the post. Sometimes I get the odd few points on Page Speed Insights on mobile performance but sitting around 65 was terrible. I installed  Better Youtube Embed Block and my page speed performance went immediately to 99! Hope you add yourself a donation button or something on the plug in. The only thing I would suggest is creating a video for those not too savy with locating the config.php file and just demonstrating how to install. Turned out to be super simple really though.
2024 年 2 月 16 日 1 則留言
This was very easy to use and does a great job.. exactly as promised. Two bonus things i found1) When upgrading existing YouTube blocks in posts, when you click the YouTube link you’ll see the option for this “Better Youtube Embeded Block” plugin. Simply click the menu and it converts it. Then click save the page! 2) It adds a caption field capability underneath that I dont think we had with the standard WP youtube block? well maybe I never noticed before ha
2024 年 2 月 12 日 2 則留言
Could you add support for max res thumbnail? I need it for shorts.And could you add support for custom thumbnail from wp media? img.youtube .com/vi/uN81SlongUw/maxresdefault.jpg
2024 年 1 月 14 日 1 則留言
Working great. Thanks.
2023 年 5 月 25 日 1 則留言
Easy to install, light code and great performances. Great job, dev!
閱讀全部 7 則使用者評論


以下人員參與了開源軟體〈YouTube Block – A better way to embed YouTube videos and speed up your site〉的開發相關工作。


〈YouTube Block – A better way to embed YouTube videos and speed up your site〉外掛目前已有 1 個本地化語言版本。 感謝全部譯者為這個外掛做出的貢獻。

將〈YouTube Block – A better way to embed YouTube videos and speed up your site〉外掛本地化為台灣繁體中文版


任何人均可瀏覽程式碼、查看 SVN 存放庫,或透過 RSS 訂閱開發記錄



Release Date – 15 June 2024

  • Added – Support custom thumbnail for videos
  • Added – Allow editing media settings in the contentOnly mode
  • Updated – Change the ‘Requires at least’ to 6.0
  • Added – Support clientNavigation interactivity


Release Date – 23 February 2024

  • Added – Add a PHP API for developers to render a YouTube video URL as this block
  • Added – A new option to load high-resolution image
  • Added – Add the ability to render all core/embed for YouTube videos as this block


Release Date – 05 January 2024

  • Added – Custom aspect ratio
  • Added – Margin support feature


Release Date – 11 August 2023

  • DEV – Update to apiVersion 3
  • DEV – Change i18 texts for translation


Release Date – 21 April 2023

  • DEV – Add keywords to the block


  • Release Date – 23 November 2022*