Plugins Plugin hub Backup SEO Caching Security Forms WooCommerce Images Best backup plugins
Hosting Hosting directory Shared hosting Managed WordPress Cloud hosting VPS hosting By reader location Hosting finder
Themes & builders Compare Rank Math vs Yoast
Tools All tools Hosting finder Plugin stack builder Cost calculator Salt generator Theme detector Who is hosting this? Speed test Headline analyzer robots.txt generator Redirect generator Uptime calculator Blog name generator
Blog Best backup plugins Deals
Guides All guides Speed up WordPress Choose hosting Back up WordPress
How we test

Setup & site building · Guide

How to Embed Videos in WordPress

How to Embed Videos in WordPress

Short answer

To embed a video in WordPress, paste its URL on its own line in the editor, or add a Video block and choose Upload, Media Library or Insert from URL. YouTube, Vimeo, TikTok, TED and many more services embed this way, while Facebook and Instagram links stay plain links. For files you host yourself, MP4 is the safest format, and short clips suit your own server best.

Key takeaways

  • Paste a video URL on its own line and WordPress turns it into a player; a URL inside a sentence stays a link.
  • WordPress plays MP4, M4V, WebM, OGV and FLV, and MP4 with H.264 is the safest choice.
  • Only public and unlisted YouTube videos can be embedded; private videos cannot.
  • VideoPress on WordPress.com allows uploads up to 6 GB with 250 GB of storage on Business and Commerce plans.
  • Captions use WebVTT (.vtt) files, added to the Video block through the Text tracks option.

What is the easiest way to embed a video in WordPress?

Paste the video URL on its own line in the editor, or add a Video block and choose Upload, Media Library or Insert from URL.

Embedding means linking to a video that lives elsewhere, such as YouTube or Vimeo, rather than uploading the file to your own site.

WordPress.org's Embeds documentation states that since WordPress 5.0, the block editor can add videos from third-party services by embedding, and that you do not need to upload the content to your site to show it.

The Video block is the tool for both jobs. WordPress.org's Video block documentation states that you add it with the + Block Inserter, or by typing /video in a new paragraph and pressing Enter. When you add it, WordPress offers three choices: Upload, Media Library and Insert from URL.

If you paste a YouTube URL into a Video block, the block turns into a YouTube embed block on its own. That behaviour comes from WordPress.org's Video block documentation, which states that inserting a URL from a supported block type transforms the Video block into that service's embed block.

How do you embed a YouTube or Vimeo video?

Paste the video URL on its own line in the editor, or add a YouTube or Vimeo block and paste the URL into it.

Follow these steps for the paste method:

  1. Copy the URL of the video from YouTube or Vimeo.
  2. Open the post or page in the block editor.
  3. Paste the URL on its own line, not inside a sentence.
  4. WordPress turns the link into a video player.
  5. Preview the post to confirm the video plays.

YouTube and Vimeo have been embeddable since WordPress 2.9, according to WordPress.org's Embeds documentation. You can also use the dedicated YouTube block or Vimeo block from the block inserter, which give the same result with a named block.

One limit applies to YouTube: only public and unlisted videos and playlists can be embedded, while private videos cannot. WordPress.org's Embeds documentation states this plainly, so check the video's visibility on YouTube first if the embed shows nothing.

The guide to using the WordPress block editor covers the editor screens used for this work.

How do you upload a video file to your own site?

Add a Video block, choose Upload, pick the file from your computer, and wait for WordPress to store it in your Media Library.

Uploading puts the file on your own hosting, so every view downloads it from your server. The Video block offers Upload for a new file, Media Library for a file you already uploaded, and Insert from URL for a file hosted elsewhere. WordPress.org's Video block documentation lists all three options.

Your host sets the largest file you can upload, so a long video may fail where a short clip succeeds. If the upload fails, compress the file or host it on YouTube or Vimeo and embed it instead. The guide to backing up WordPress matters here too, since video files make backups much larger.

Keep uploaded videos short. A two-minute clip at 1080p is a reasonable size for most hosts, while a 30-minute video belongs on a video host, not your server.

Which video formats work in WordPress?

WordPress plays MP4, M4V, WebM, OGV and FLV, and MP4 is the safest choice for every browser.

WordPress's own code lists these five as the supported video formats. The wp_get_video_extensions() function on WordPress's developer site returns mp4, m4v, webm, ogv and flv as the defaults, and notes that the list has been in place since WordPress 3.6.0.

MP4 with H.264 video is the format to use when you ship one file. It plays in every modern browser, and it is the format WordPress.com recommends for VideoPress uploads, as the next section shows. WebM is a smaller alternative, but older browsers and some Apple devices handle it less well.

Convert other formats before you upload. A MOV file from a phone or camera may upload fine but fail to play in the browser, since MOV is not on the supported list. Export it as MP4 first, and the video will play for every visitor.

FormatPlays in WordPressUse it when
MP4 (H.264)YesAlmost always, the safe default
WebMYesYou need a smaller file and accept narrower support
M4VYesThe file comes from Apple tools
OGVYesYou need an open format for short clips
FLVYesOnly for old files, avoid for new video
MOVNo, it stores but does not playNever upload, convert to MP4 first

How do you control how the video plays?

Use the Video block settings to set autoplay, loop, mute, playback controls, preload and a poster image.

Click the block and open the Settings tab in the sidebar. WordPress.org's Video block documentation lists the settings: Autoplay, Loop and Muted set whether the video starts on its own, repeats, and plays silent. Play inline keeps the video inside the page on phones, and Playback controls shows or hides the play bar.

Preload decides how much of the file downloads before a visitor presses Play. The three choices are Auto, Metadata and None.

Auto downloads the whole file, Metadata downloads only basic file info, and None downloads nothing until Play is pressed. WordPress.org's Video block documentation calls None the fastest setting, and warns that Auto can slow the page a lot with large files.

Choose a poster image to show before the video plays. The poster is the still frame visitors see first, so pick a clear frame that shows what the video is about. The block toolbar also lets you align the video, add a caption, and replace the file without deleting the block.

Leave autoplay off unless you have a clear reason to turn it on. If you do use it, turn on Muted too, since most browsers block autoplay with sound.

How do you add captions or subtitles to a video?

Upload a WebVTT (.vtt) file to the Video block with the Text tracks option, and pick Subtitles or Captions as the kind.

WordPress.org's Video block documentation states that the Text tracks option shows timed text tracks such as subtitles or captions while the media plays, and that tracks use the WebVTT format. A WebVTT file is a plain text file with time stamps, such as 0:02:14.000 --> 0:02:15.000 followed by the words spoken.

The block offers five kinds of track: Subtitles, Captions, Descriptions, Chapters and Metadata.

Subtitles translate dialogue when the sound is on but not understood, while Captions transcribe dialogue, sound effects and music for viewers who cannot hear the audio. Descriptions tell a screen reader what happens in the video, Chapters mark sections viewers can jump to, and Metadata holds data for scripts rather than text for viewers.

Set the source language for each track with a valid language tag, such as en for English. If the kind is Subtitles, WordPress requires the source language to be set. The guide to what a block theme is explains the theme types that show these block settings.

Which services can you embed from, and which can you not?

WordPress embeds YouTube, Vimeo, TikTok, TED, Bluesky, Canva and many more, but Facebook and Instagram embeds stopped working in 2020.

WordPress keeps a list of trusted oEmbed providers, and only URLs from that list turn into players.

WordPress.org's Embeds documentation lists the services, with the WordPress version that added each one. YouTube and Vimeo date back to WordPress 2.9, TikTok arrived in WordPress 5.4, Bluesky in WordPress 6.6, and Canva in WordPress 6.8, according to the oembed_providers reference on WordPress's developer site.

Facebook and Instagram are the big exceptions. Facebook closed its oEmbed endpoint, so the blocks stopped working after 24 October 2020.

WordPress.org's Embeds documentation states that embedding those links now needs a developer account, an app ID and an authentication token. Paste a Facebook or Instagram link today and you will get a plain link, not a player.

If a paste does not turn into a player, check two things: the service must be on the trusted list, and the URL must sit on its own line with no link formatting. A URL inside a sentence stays a link, and a URL from a service outside the list stays a link too.

When should you host video yourself, and when should you use VideoPress or YouTube?

Embed from YouTube for public video, use VideoPress for ad-free video on your own domain, and upload to your own server only for short clips.

YouTube is free and handles the bandwidth, but it shows YouTube branding and may show related videos after yours ends. It suits public videos that should also be found on YouTube itself, such as tutorials and talks.

VideoPress hosts the video on WordPress.com servers instead of your host, with an ad-free player and no YouTube branding.

On WordPress.com it comes with the Business and Commerce plans, with 250 GB of dedicated video storage, as WordPress.com's VideoPress page states. The same page states that uploads can reach 6 GB per file and play at up to 4K resolution, while videos longer than 3 hou rs convert to standard resolution.

Jetpack VideoPress brings the same hosting to self-hosted sites. Jetpack's VideoPress upload guide recommends 1080p files, caps files at less than 5 GB, and lists 8 Mbps for 1080p30 and 12 Mbps for 1080p60 as the bit rates to aim for. Jetpack's [private video hosting](https://jetpack.com/resources/

private-video-hosting-platforms/) page lists 1 TB of storage and a price of $4.95 a month for the first year, billed yearly, as of November 2026.

RouteCostBrandingBest for
YouTube embedFreeYouTube player and related videosPublic videos, widest reach
Vimeo embedFree tier, paid plans for moreVimeo playerClean player, creative work
VideoPress on WordPress.comBusiness plan and aboveNo ads, WordPress playerAd-free video on your domain
Jetpack VideoPress$4.95 a month, first yearNo ads, WordPress playerSelf-hosted sites, 1 TB storage
Upload to your own serverHosting cost onlyYour own playerShort clips under a few minutes

What mistakes should you avoid?

Do not upload long videos to your own server, do not autoplay with sound, and do not skip captions.

These mistakes cause most video problems:

  • Uploading a 30-minute video to your own host, which slows the page and eats your storage.
  • Turning on autoplay with sound, which most browsers block and visitors dislike.
  • Setting preload to Auto on a page with several videos, so the page downloads them all before anyone presses Play.
  • Uploading a MOV file and finding it stores but never plays.
  • Pasting a private YouTube link and getting a blank player instead of a video.
  • Skipping captions, which shuts out viewers who watch muted or cannot hear the audio.
  • Embedding a Facebook or Instagram link and expecting a player, years after those embeds stopped working.

WordPress 7.1 added a Transform to variation button for the Video block, which turns a video into a Gif variation in one click, according to the changelog on WordPress.org's Video block documentation, updated on 1 September 2026.

After you publish a video, open the page in a private browser window and press Play. Check that the video starts, that the sound works, that the captions show, and that the page still loads fast. The guide to adding custom CSS in WordPress covers style fixes if the player needs a small visual change.

Frequently asked questions

Why does my YouTube video not embed in WordPress?

Check that the video is public or unlisted, since private YouTube videos cannot be embedded. Then check that the URL sits on its own line with no link formatting, since a URL inside a sentence stays a link. If both are right, confirm the video page loads on YouTube itself, since a removed or age-restricted video will not embed either.

Can I upload a video directly to WordPress?

Yes. Add a Video block, choose Upload, and pick the file from your computer. WordPress stores it in your Media Library and plays it with its own player. Your host sets the largest file you can upload, so long videos may fail. For anything longer than a few minutes, embed from YouTube or Vimeo, or use VideoPress, instead.

What is the difference between embedding and uploading a video?

Embedding links to a video hosted elsewhere, such as YouTube, so the file lives on their servers and their player shows it. Uploading stores the file on your own hosting, so every view downloads it from your server. Embedding costs you no storage or bandwidth, while uploading gives you full control over the file and the player.

How do I make a video autoplay in WordPress?

Open the Video block settings and turn on Autoplay, then turn on Muted as well. Most browsers block autoplay with sound, so a muted autoplay is the only kind that reliably starts on its own. Think twice before using it: a video that starts without warning annoys many visitors, and leaving playback in their hands is usually better.

Can I embed a Facebook or Instagram video in WordPress?

Not with a plain paste. Facebook closed its oEmbed endpoint, so Facebook and Instagram embeds stopped working after 24 October 2020. Embedding those links now needs a developer account, an app ID and an authentication token. Pasting the link today gives you a plain link, not a player, so host the video elsewhere or link out to it.

Sources

  1. Embeds WordPress.org
  2. Video block WordPress.org
  3. wp_get_video_extensions() WordPress Developer Resources
  4. Host videos with VideoPress in WordPress WordPress.com Support
  5. Ad-Free Video Hosting for Websites WordPress.com
  6. Upload your videos on Jetpack VideoPress Jetpack
  7. Top 6 Private Video Hosting & Sharing Platforms (Ad-Free) Jetpack

Is your product missing, or something out of date?

Tell us what to add or correct. We read every note and reply when we need a source. A message does not buy a ranking.

About the editors

Written and checked byWPLegible Editorial Team Independent WordPress reviews and guides

Researched from the primary sources listed above and checked against our editorial rules before publishing.