Blogging & content · Guide
How to Post a Video on WordPress (Step by Step)

Short answer
To post a video on WordPress, paste a YouTube or Vimeo link on its own line in the editor so it embeds automatically, or add a Video block and upload an MP4 file. Embedding is usually better because the platform handles streaming and bandwidth for you.
Key takeaways
- Pasting a YouTube or Vimeo URL creates an embed automatically.
- The Video block uploads files to your media library.
- MP4 with H.264 video plays in almost every browser.
- Autoplay only works reliably when the video is muted.
- Embedding saves hosting storage and bandwidth.
How do you post a video on WordPress?
You post a video on WordPress by adding a Video block for an uploaded file, or by pasting a YouTube or Vimeo link into the editor so WordPress embeds it automatically.
Both methods take less than a minute. The real choice is where the video file lives: on your own hosting, or on a video platform that streams it for you.
This guide covers both routes in the block editor, plus the classic editor, page builders and the settings that control how the video plays.
| Method | Best for | File stored on |
|---|---|---|
| Paste a YouTube or Vimeo URL | Most blog posts and long videos | The video platform |
| Video block with upload | Short clips, background videos, private content | Your WordPress hosting |
| Video block with media library file | Reusing a video already uploaded | Your WordPress hosting |
| Page builder video widget | Elementor or similar layouts | Either |
Should you upload the video or embed it?
For most sites, embedding from YouTube or Vimeo is the better choice, because those platforms handle streaming, compression and bandwidth so your hosting does not have to.
Uploading video straight to WordPress uses your storage and bandwidth. A popular video can slow the whole site, and many shared hosting plans set low upload limits.
Uploading still makes sense for short clips, silent background loops, or content you do not want on a public platform.
We compare the trade-offs in detail in our guide on self-hosting videos vs embedding YouTube.
How do you embed a YouTube video in a post?
To embed a YouTube video, copy the video's URL from your browser, paste it on its own line in the block editor, and WordPress turns it into a playable embed.
Here are the steps:
- Open YouTube and go to the video you want.
- Click Share and copy the link, or copy the URL from the address bar.
- In WordPress, open your post with Posts > Add New or edit an existing one.
- Click where you want the video and paste the link on an empty line.
- WordPress converts it into a YouTube embed block with a preview.
- Click Save draft or Publish.
You can also add the block yourself. Click the + inserter, search for YouTube, add the block, then paste the URL into the field.
YouTube explains its sharing and embed options in its help center, including how to turn on privacy-enhanced mode.
This works because WordPress supports oEmbed for a list of trusted providers. The official embeds documentation lists the supported services, including YouTube, Vimeo, TikTok and others.
If the embed shows as a plain link, the video may not allow embedding, or a plugin may be blocking it. Our guide on WordPress videos not working covers those fixes.
How do you upload a video with the Video block?
To upload a video file, add a Video block, click Upload, pick an MP4 file from your computer, and WordPress stores it in the media library and shows a player.
Follow these steps:
- In the editor, click the + inserter and search for Video.
- Add the Video block where you want it.
- Click Upload to choose a file, Media Library to reuse one, or Insert from URL for a direct file link.
- Wait for the upload to finish. Large files can take a while.
- Set the playback options in the block sidebar.
- Save or publish the post.
The block settings are described in the official Video block documentation.
If the upload fails, the file is probably bigger than your server allows. Our guide on increasing the max upload size shows how to raise that limit.
What video format should you upload?
Upload MP4 files that use the H.264 video codec and AAC audio, because nearly every browser and device can play that combination.
WordPress accepts several video extensions, including MP4, M4V, WebM, OGV, MOV and others. Accepting a file is not the same as the browser being able to play it, though.
Videos recorded on newer phones are often HEVC (H.265). They may upload fine but show a black box in some browsers. Re-encoding them to H.264 avoids this.
MDN keeps a clear reference of video codecs used on the web if you want to check browser support.
Keep files small. Compress before uploading, and pick a sensible resolution such as 1080p rather than 4K for an inline blog video.
Which Video block settings should you change?
The most useful Video block settings are autoplay, loop, muted, playback controls, plays inline, preload and the poster image.
| Setting | What it does | When to use it |
|---|---|---|
| Autoplay | Starts the video when the page loads | Only with muted, for short loops |
| Loop | Restarts the video when it ends | Background clips and short demos |
| Muted | Starts with no sound | Required for autoplay in most browsers |
| Playback controls | Shows play, pause and volume | Leave on for normal videos |
| Plays inline | Plays inside the page on iPhones | Turn on for background or autoplay clips |
| Preload | How much loads before play | Metadata or None to save bandwidth |
| Poster image | Picture shown before playing | Always, for a cleaner look |
Browsers block autoplay with sound, so an autoplay video that is not muted often just sits there. Our guide to Elementor video autoplay settings explains the same rule for page builders.
A poster image matters more than it seems. Without one, visitors see a blank or random frame until the video loads.
How do you add a caption or subtitles?
You add a caption by typing in the caption area under the Video block, and you add subtitles by uploading WebVTT track files in the block's text tracks option.
Captions under the video are short descriptions, like an image caption. They are optional but help readers scan the post.
Subtitles are different. They appear on top of the video while it plays. In the Video block toolbar, open the Text tracks option and upload a .vtt file for each language.
Subtitles help deaf and hard-of-hearing visitors and anyone watching with the sound off. YouTube and Vimeo embeds use the subtitles you set on those platforms instead.
How do you post a video in the classic editor?
In the classic editor, paste the YouTube or Vimeo link on its own line in the Visual tab, or click Add Media to upload a video file and insert it into the post.
Uploaded videos are inserted with the [video] shortcode, documented in the wp_video_shortcode reference. That shortcode accepts options such as autoplay, loop, poster and preload.
If your site still uses the classic editor, the embed still works the same way as in the block editor. Plain URLs on their own line become embeds.
If you want to switch, our guide on enabling the Gutenberg editor explains how.
How do you add a video with Elementor or another page builder?
In Elementor, drag the Video widget onto the page, choose the source such as YouTube, Vimeo or self-hosted, then paste the link or pick the file from the media library.
Other builders work in a similar way. Look for a video module or element, choose the source, and set autoplay, mute, loop and controls in the widget options.
Page builders also let you use videos as section backgrounds. Keep these short, muted and compressed, because they load on every visit.
How do you keep videos from slowing down your site?
Videos slow sites mainly by loading heavy player scripts and large files on page load, so lazy loading embeds and using poster images keeps pages fast.
A YouTube embed loads a lot of JavaScript even before anyone presses play. Many speed plugins can replace the embed with a lightweight preview image until it is clicked.
Our guide on speeding up YouTube embeds covers this technique and the plugins that offer it.
For self-hosted video, set preload to Metadata or None. That stops the browser downloading the whole file before the visitor decides to watch.
Also avoid putting several videos high on the same page. One video above the fold is usually enough.
What should you check before you publish?
Before publishing, preview the post on desktop and mobile, press play, and make sure the video loads, plays with sound and looks right at different screen sizes.
Run through this quick list:
- The video plays in Chrome, Safari and on a phone.
- Autoplay videos are muted and set to play inline.
- The poster image looks good.
- The page still loads quickly.
- Captions or subtitles are in place if needed.
- The surrounding text explains what the video is about.
Search engines cannot watch your video, so a short summary or key points in text helps both readers and SEO.
If you need to replace the file later, see our guide on replacing a media file in WordPress.
Frequently asked questions
Can I upload a video directly to WordPress?
Yes. Add a Video block, click Upload and choose a file such as an MP4. The file goes into your media library. Keep it small, because your hosting serves every view, and large files may hit the upload limit set by your server.
Why does my YouTube link not turn into a video?
The link must sit on its own line with no other text, and the video must allow embedding. Privacy or speed plugins can also block the embed. Try the dedicated YouTube block, or paste the standard watch link instead of a shortened one.
What is the maximum video size I can upload to WordPress?
It depends on your hosting. The limit is set by PHP settings such as upload_max_filesize and post_max_size. You can see your current limit in the media uploader. Many hosts let you raise it from the control panel.
How do I make a WordPress video autoplay?
Turn on Autoplay in the Video block settings and also turn on Muted, because browsers block autoplay with sound. Turn on Plays inline so it works on iPhones. For YouTube embeds, autoplay depends on YouTube's own player rules.
Is it better to embed or self-host videos on WordPress?
Embedding is better for most sites because YouTube or Vimeo handle compression, streaming and bandwidth. Self-hosting suits short clips, background loops or private content where you want full control and no platform branding.
Sources
- Video block WordPress.org
- Embeds WordPress.org
- Video codecs used on the web MDN Web Docs
- Embed videos and playlists YouTube Help
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.
Thanks — we review requests within 3 business days.
Related guides
About the editors
Researched from the primary sources listed above and checked against our editorial rules before publishing.


