How to Embed a Video in WordPress (YouTube, Vimeo and More)

By Seahawk October 31, 2022 4 min read

Adding a video to a WordPress page takes about a minute, and you do not need a plugin or any code. This short Seahawk Learn video shows the basic method: copy the video's URL, paste it into the editor, and let WordPress embed it for you. This article repeats those steps for the current block editor and adds tips for sizing, hosting and troubleshooting.

Seahawk Learn · How to Embed Videos in Your WordPress Website | Seahawk Learn · 3:25

How video embedding works in WordPress

WordPress supports a feature called oEmbed. When you paste the address of a supported service on its own line, WordPress asks that service for the player code and shows it for you. YouTube and Vimeo are among the supported services, and you can embed videos from many others. Because the video stays on the other service's servers, it does not use your hosting bandwidth or storage, which keeps your site lighter.

How to embed a video step by step

  1. Find your video. Open the video on YouTube or another supported site.
  2. Copy the URL. Click the address bar in your browser and copy the full web address. On YouTube you can also use the Share button and copy the link.
  3. Open the editor. Edit the page or post where the video should appear.
  4. Paste the link. Click an empty paragraph block and paste the URL. WordPress turns it into an embedded player automatically.
  5. Preview and update. Check it in the editor, then click Update or Publish and view the page on the front end.

The video describes this in the visual editor. In the block editor, the same pasted link converts into an embed block, and you will see the player straight away.

Using the embed blocks

If pasting does not trigger the player, add a block deliberately. Click the plus icon, search for YouTube, Vimeo or Embed, add the block and paste the URL into it, then click Embed. You can also change alignment and add a caption, and the embed scales with your content column.

Uploading your own video file

The Video block lets you upload a file to the media library and play it on the page. That works for short clips, but video files are large and use hosting storage and bandwidth. For anything long or popular, hosting on a video platform is usually the better choice, as we explain in reasons to avoid hosting your own videos.

Making embedded videos look right

  • Responsive width: embed blocks usually scale to the content column. Avoid fixed pixel widths.
  • Alignment: use the block toolbar to centre the video or make it wide if your theme supports it.
  • Captions: a short caption helps readers and search engines understand the video.
  • Autoplay: avoid it. Browsers often block it, and visitors do not like it.
  • Placement: put the video near the text that explains it, not at the very bottom of the page.

Speed tips for pages with video

Embedded players load scripts from the video service, which can slow a page. Use lazy loading so the player only loads when it is close to the screen; see our guide to lazy loading images and videos in WordPress. Avoid putting many players on one page, and test the page speed afterwards.

Troubleshooting embeds that do not work

  • The URL stays as plain text. Make sure the link is on its own line, with no surrounding text, and that it starts with https.
  • The video says unavailable. The owner may have disabled embedding or set the video to private. Check its settings on the source site.
  • Blank space or an error. A security or caching plugin may be blocking the embed. Clear your cache and test with plugins disabled on a staging site.
  • The theme looks broken after embedding. Check that your theme handles responsive embeds, or try the dedicated embed block.

If a recent update changed how embeds behave, our guide on fixing a WordPress site after an update can help. Embedding other content works in a similar way; for documents, see how to embed a PDF in WordPress.

The steps in the video

The video is short and has no chapter timestamps. It covers three things: finding the video and copying its URL from the address bar, opening the WordPress editor, and pasting the URL so WordPress embeds the video automatically.

Quick checklist for embedding videos

Copy the full URL, paste it on its own line in the editor, preview the result and update the page. Use a video platform for anything large, add a caption, and check the page on your phone. If you ever need more control over the player, look for an open-source video plugin in the WordPress plugin directory, but for most sites the built-in embed is all you need.

FAQs

How do I embed a YouTube video in WordPress?

Copy the video's URL from YouTube, open the page or post in the editor, and paste the URL into an empty paragraph block. WordPress converts it into an embedded player automatically.

Do I need a plugin to embed videos?

No. WordPress supports embedding from services like YouTube and Vimeo by default through oEmbed, so pasting the URL is enough.

Why is my video link showing as text instead of a player?

The link must be on its own line and use the full https address. The video may also be private or have embedding disabled by its owner.

Should I upload videos to WordPress directly?

Short clips can work, but video files are large and use hosting storage and bandwidth. For longer or popular videos, embedding from a video platform is usually better.

Will embedded videos slow my site down?

They can, because players load external scripts. Lazy loading the player and limiting the number of videos per page helps.

Seahawk Learn for brands

Want a deeper dive than a product review?

Product reviews are short write-ups. A Seahawk Learn video goes deeper: a full walkthrough of your product on our YouTube channel and here, with a written step-by-step guide.