Title: YouTube embed Author: Birgit Pauli-Haack Published: April 21, 2020 Last modified: June 9, 2024 --- # YouTube embed ## In this article * [Embed other YouTube links](https://wordpress.org/documentation/article/youtube-embed/?output_format=md#embed-other-youtube-links) - [Playlist](https://wordpress.org/documentation/article/youtube-embed/?output_format=md#playlist) - [Live Streams](https://wordpress.org/documentation/article/youtube-embed/?output_format=md#live-streams) - [Unsupported URLs](https://wordpress.org/documentation/article/youtube-embed/?output_format=md#unsupported-urls) * [Block Toolbar](https://wordpress.org/documentation/article/youtube-embed/?output_format=md#block-toolbar) * [Block Settings](https://wordpress.org/documentation/article/youtube-embed/?output_format=md#block-settings) - [Media Settings](https://wordpress.org/documentation/article/youtube-embed/?output_format=md#media-settings) * [Changelog](https://wordpress.org/documentation/article/youtube-embed/?output_format=md#changelog) [ Back to top](https://wordpress.org/documentation/article/youtube-embed/?output_format=md#wp--skip-link--target) [Go back to the list of **Blocks**](https://wordpress.org/documentation/article/blocks/) ![YouTube icon](https://wordpress.org/documentation/files/2020/04/Screen-Shot-2020- 04-21-at-8.52.08-AM.png) Using the YouTube Embed block you can include a YouTube video into your post/page with play buttons, so your visitor can stay on your site to watch it. You don’t need a YouTube account to embed a video. Not all videos can be shared this way, though. The publisher needs to “Allow Embedding” in the settings of the video and some publishers restrict the countries, where videos can be shared. ![This setting can be found YouTube Studio: Edit Video > More Options > Check "Allow embedding](https://wordpress.org/documentation/files/2020/04/Screen-Shot-2020-04- 21-at-8.54.45-AM.png) This setting can be found YouTube Studio: Edit Video > More Options > Check “Allow embedding Non-personal identifying viewing data will be shared with YouTube and the publisher of the video. _Please consult the [privacy policies and information](https://support.google.com/policies/answer/9664901) on YouTube if your site is visited by children._ **Six Steps to embed a YouTube Video in your post or page** 1. Find your video on YouTube.com, and copy the URL of the video from the browser bar ![](https://wordpress.org/documentation/files/2020/04/YouTube-Embed-URL.jpg) 2. **Add a YouTube Embed block to your post. ** ![Select a YouTube block for Gutenberg Page Builder](https://wordpress.org/documentation/ files/2022/02/youtube-block-add-wordpress-5-9.png) Adding a block via the “Slash” command from an empty row [Detailed instructions on adding blocks](https://wordpress.org/documentation/article/adding-a-new-block/) 3. **Paste the YouTube URL **from Step 1 4. **Click on the “Embed” Button** ![YouTube URL paste example into block](https://wordpress.org/documentation/files/ 2022/02/youtube-block-add-url-5-9-1024x411.png) 5. **You see the YouTube video in your editor.** ![Example of video being added in block - WordPress 5.9](https://wordpress.org/documentation/ files/2022/02/youtube-block-post-embed-1024x830.png) After Embed of a YouTube video 6. **Clicking on Preview**, will show you the display on the front end of your page. ![YouTube Video Block - Embed Success](https://wordpress.org/documentation/files/ 2020/04/Screen-Shot-2020-04-21-at-9.32.38-AM.png) ## 󠀁[Embed other YouTube links](https://wordpress.org/documentation/article/youtube-embed/?output_format=md#embed-other-youtube-links)󠁿 ### 󠀁[Playlist](https://wordpress.org/documentation/article/youtube-embed/?output_format=md#playlist)󠁿 A playlist URL can be embedded and the first video of the list shows in the embed box, with additional navigation for the playlist in the top right corner. ![Playlist example of YouTube Gutenberg Block](https://wordpress.org/documentation/ files/2022/02/youtube-block-playlist-example-5-9-1-1024x812.png) ### 󠀁[Live Streams](https://wordpress.org/documentation/article/youtube-embed/?output_format=md#live-streams)󠁿 YouTube Live stream URLs are supported in the form of `youtube.com/live/videocode` ### 󠀁[Unsupported URLs](https://wordpress.org/documentation/article/youtube-embed/?output_format=md#unsupported-urls)󠁿 Not all YouTube links can be used for an embed. When an URL is used that is not suited for embedding, the Block editor offers you two options: to try a different URL or convert the current URL into a Text link. ![Sorry - Content cannot be embedded example from Youtube.](https://wordpress.org/ documentation/files/2022/02/youtube-block-video-not-found-1024x683.png) ## 󠀁[Block Toolbar](https://wordpress.org/documentation/article/youtube-embed/?output_format=md#block-toolbar)󠁿 Next to the YouTube icon is the “Drag & Drop Handle”. This can be used to drag your block to another section of your page. Next to this is the “Mover”. Up and Down options are presented. ![Block toolbar for the YouTube block](https://wordpress.org/documentation/files/ 2022/02/youtube-block-toolbar-5-9.png) YouTube block toolbar **Change Alignment** After the first separator line you have the “Change alignment” tool. ![Changing alignment for the YouTube block](https://wordpress.org/documentation/ files/2022/02/youtube-block-toolbar-alignment.png) Change alignment option – YouTube Block The alignment has variable options depending on your theme. * **None – Default alignment option.** * **Wide width – Increase the width of the post beyond the content size.** * **Full width – Extend the block to cover the full width of the screen.** * **Align left – Make the block left-aligned.** * **Align center – Make the block alignment centered.** * **Align right – Make the block right aligned.** “Wide width” and “Full width” alignment need to be enabled by the Theme of your site.  **Edit URL** Clicking on the Edit button will bring up the view for adjusting your URL for the Video Embed. ![YouTube URL paste example into block](https://wordpress.org/documentation/files/ 2022/02/youtube-block-add-url-5-9-1024x411.png) Via the edit URL, you can change the YouTube Embed URL in the embed block. Overwrite the existing URL and click on the “Embed” button on the right. **More Options** These controls give you the option to copy, duplicate, and edit your block as HTML. [Read about these and other settings.](https://wordpress.org/documentation/article/more-options/) ## 󠀁[Block Settings](https://wordpress.org/documentation/article/youtube-embed/?output_format=md#block-settings)󠁿 Besides the “Advanced” section, the YouTube embed has only one setting in the “Block Settings” sidebar: Media Settings. ### 󠀁[Media Settings](https://wordpress.org/documentation/article/youtube-embed/?output_format=md#media-settings)󠁿 ![](https://wordpress.org/documentation/files/2020/04/Screen-Shot-2020-04-20-at- 9.29.46-AM.png) ![](https://wordpress.org/documentation/files/2020/04/Screen-Shot-2020-04-20-at- 9.29.55-AM.png) Via the _Media Settings_ you can control the behavior of your post embed when viewed from a smaller device, like on a phone screen. The Toggle switch turns on or off the resize functionality for smaller devices. The default setting is “on” or blue. **“Off:”** This embed may not preserve its aspect ratio when the browser is resized. In the off position the toggle switch is gray. **“On:”** This embed will preserve its aspect ratio when the browser is resized. The toggle switch turns blue in the “On” position. **Advanced** The advanced tab lets you add a CSS class to your block, allowing you to write custom CSS and style the block as you see fit. [[ The advanced section lets you add a CSS class to your block. For a YouTube embed there are default CSS classes to allow for responsive handling of the embed when viewed on smaller devices like mobile phones. ## 󠀁[Changelog](https://wordpress.org/documentation/article/youtube-embed/?output_format=md#changelog)󠁿 * Updated 2023-08-24 - Added Live Streams section * Updated 2022-11-23 - Removed redundant data - added alt text on some images - aligned images for mobile view * Updated 2022-02-04 - Change Screenshots to 5.9 - Removed the group area from toolbar options - Updated the flow of the document to represent what is in the toolbar - Updated labels for more settings to fit 5.9 * Updated 2020-08-18 - Replaced “More Options” – new screenshot - Added “Move To” and “Copy” section under More Options * Updated 2020-05-26 - Fixed some typos * Created 2020-04-21 ## Was this article helpful? How could it be improved? 󠀁[Cancel reply](https://wordpress.org/documentation/article/youtube-embed/?output_format=md#respond)󠁿 [Log in to submit feedback](https://login.wordpress.org/?redirect_to=https%3A%2F%2Fwordpress.org%2Fdocumentation%2Farticle%2Fyoutube-embed%2F&locale=en_US). If you need support with something that wasn't covered by this article, please post your question in the [support forums](https://wordpress.org/support/forums/). First published April 21, 2020 Last updated June 9, 2024