Back to Support Content and Media Blocks YouTube Block

YouTube Block

Use the YouTube block to embed YouTube videos onto any area of your website. This guide will show you how to add a YouTube video to your site.

Add a YouTube Video

First, copy the YouTube video’s URL from your web browser’s address bar while viewing the video. Videos on YouTube typically use the URL format:

A YouTube link in a browser’s address bar

To quickly add the video to any page of your site, paste the URL on a new line in the WordPress editor. The link will automatically turn into an embedded YouTube video player:

GIF showing the process of pasting a YouTube link, and it automatically turns into a video player.
Quickly embed a YouTube video by pasting the video URL on a new line

Support is included for standard YouTube videos, YouTube playlists, and live streams.

If you wish to add a YouTube link without it turning into an embedded player, type some text before the URL like we’re doing in this very sentence: The link will only turn into an embedded player if it is on its own line with nothing else. Alternatively, you can add the link between two backtick symbols ` and it will appear like this:

YouTube also provides an iframe embed option, which you can insert via a Custom HTML block.

Add a YouTube Block

Alternatively, you can first add a YouTube block. To add the YouTube block, click on the + Block Inserter icon and search for “youtube”. Click it to add the block to the post or page. Paste the YouTube URL in the box provided and click Embed.


Using your keyboard, you can also type /youtube on a new line and press enter to quickly add a new YouTube block.

Adding a YouTube block using the slash inserter.
Adding a YouTube block with the slash inserter.

For more information, visit our detailed instructions on adding blocks.

Block Toolbar

When you click on the block, a toolbar of options will appear above it:

The YouTube block offers the following options in its toolbar:

Block Settings

When you select a block, you will find additional block settings in the right sidebar. If you do not see the sidebar, you may need to click the Settings icon in the top-right corner to bring up the settings. This icon looks like a square with two uneven columns:

The settings icon in the Editor with a tooltip "Settings" below it.
Click the Settings icon to open the block settings
Media Settings

Keep the option Resize for smaller devices enabled if you’d like to preserve the aspect ratio on different browser sizes.

Media Settings shows the option to "Resize for smaller devices" toggled on.
YouTube video without the Resize for smaller devices enabled.
With the Resize for smaller devices disabled
With the Resize for smaller devices enabled
Additional Settings

The YouTube block also includes:

Was this guide helpful for you?

Not quite what you're looking for? Get Help!

Copied to clipboard!