The Video block's Preload option decides how much of your video file a visitor downloads before they click Play. WordPress's own block documentation describes it as an option that "allows you to select how much of the video file is downloaded when the page or post is loaded."
This guide walks through where that choice actually bites, what each documented setting does in the official wording, and one oddity worth knowing: the Video block page and the Audio block page describe the same HTML5 preload attribute with a different number of options.
Before you start
You need three things: a video that lives in your own Media Library, a Video block holding it, and a moment of honesty about the file's size — the setting only changes when bytes are fetched, not how many there are.
One caveat before the block options matter at all. Both sets of official documentation warn that the Video block is not sticky when you paste a link. The self-hosted docs say: "If you insert a URL from a supported block type, such as YouTube, the Video block will automatically transform into a YouTube embed block." The WordPress.com help centre says the same thing in its own words: "If you paste a link from a popular site like YouTube or Vimeo, the Video block will automatically change to the matching Embed block, such as the YouTube Embed block."
Preload is documented as a Video block option. If your block has turned into a YouTube or Vimeo embed, you are reading a different block's settings.
Step 1 — Understand what you are trading
Read the official framing before you touch the dropdown, because it tells you which direction the risk runs:
"This option allows you to select how much of the video file is downloaded when the page or post is loaded. While it may be tempting to go ahead and have the whole file download automatically, keep in mind that this can slow your page's load speed down."
That is WordPress telling you, in its own documentation, that the most eager option is the one that costs you.
Step 2 — Pick from the three documented settings
The Video block documentation states: "There are three settings:" — Auto, Metadata and None. Two of them are spelled out verbatim.
Auto. "The entire video file is downloaded, regardless of whether the visitor clicks the Play button or not. This makes the biggest impact on your page or post's load speed, especially with larger video files."
None. "Nothing about the video file is downloaded automatically. The download of the video file only begins when your visitor clicks the Play button. This is the fastest setting."
Metadata sits between them in the list. For its exact documented behaviour, check the official documentation — the wording is not something to guess at from the name.
So the two ends of the range are unambiguous, and WordPress labels them for you: Auto has "the biggest impact" on load speed, None "is the fastest setting." If most visitors scroll past your video without pressing Play, None is the choice the documentation points at.
Step 3 — Set a poster image
This pairs with Preload, because a video that downloads nothing until clicked still has to show the visitor something. The documentation covers it: "You can choose a poster image that will be displayed before a video is set to play. This can be useful if the first frame of the video isn't necessarily appealing or indicative of the video content."
Step 4 — Check the neighbouring playback options
Two more Video block options are worth a glance while you are in there.
Play inline — "This option lets you set your video to be played inline, that is within the element's playback area. Keep in mind that turning this option off does not imply that the video will always be played in fullscreen."
On WordPress.com, the Video block documentation adds an Autoplay toggle, with a warning attached: "Toggle this option to play the video automatically when the page is loaded. Keep in mind that while autoplay is supported on WordPress.com, some modern browsers do not support this feature and will block a video from autoplaying upon visiting a page." The same page describes Playback Controls as giving the viewer "a play button, volume controls, HD mode, playback speed, picture-in-picture, and full-screen options."
The detail nobody mentions: three settings, or four?
Here is the part that trips people up when they compare notes. The Video block documentation says "There are three settings:". The Audio block documentation, describing the same HTML5 preload attribute, says "There are four settings:" — and the extra one is spelled out:
"Browser default – Use settings from site visitor's browser."
Two official block pages, one attribute, two different option counts. We are not going to adjudicate which page is right; the useful takeaway is practical. If you read a tutorial that lists a "Browser default" preload option and your Video block does not show one, you are not going mad — that option is documented on the Audio block page, not the Video block page. Check the official documentation for the block you are actually editing rather than assuming the two match.
The setting is not the bottleneck — the file is
Preload controls when the download starts. It does nothing about how big the download is. That is where compression does the work the dropdown cannot.
WordPress says as much about its own hosted video service: VideoPress videos are "optimized for progressive loading, so viewers can start watching while the video continues to download," and the documentation adds flatly that "Videos that are smaller or compressed will load faster for your viewers." WordPress.com's file-size guidance gives the same instruction for uploads that are struggling: "Compress the file to reduce its size, then upload it again."
Try it right here
Runs in your browser. Your file is not uploaded anywhere.
This runs inside your browser tab — the file is read from disk, re-encoded locally and handed straight back, so nothing is uploaded anywhere on the way to being shrunk. It works identically whether your site is self-hosted or on WordPress.com.
One encoding detail is worth aligning with. WordPress.com's recommended video settings list "Fast Start / Web Optimized / progressive download (so the whole file doesn't need to be downloaded before playback can begin)" under Other Settings. Keep the stated scope in mind: that table is presented as the recommendation "for best results, and highest compatibility with other WordPress editor blocks (other than the Video or VideoPress block) such as the Cover or Story blocks" — it is not documented as a requirement for the Video block itself.
Common mistakes
- Choosing Auto because it sounds like the safe default. The documentation says it downloads the entire file "regardless of whether the visitor clicks the Play button or not," and calls it the biggest impact on load speed.
- Setting Preload on what is actually an embed block. Paste a YouTube or Vimeo link and the block transforms, per both official docs.
- Expecting a "Browser default" option in the Video block. That wording appears in the Audio block documentation's list of four.
- Treating Preload as a substitute for compression. It changes the timing of the download, not its size.
- Turning off Play inline and expecting fullscreen. The docs explicitly say that "turning this option off does not imply that the video will always be played in fullscreen."
FAQ
What does the WordPress Video block preload setting do? It selects "how much of the video file is downloaded when the page or post is loaded," in the documentation's words. It does not change the file itself.
Which preload setting is fastest? None. The documentation calls it "the fastest setting" and says the download "only begins when your visitor clicks the Play button."
Why does my Audio block have four preload options and my Video block three? Because that is what the two official pages say. The Video block page reads "There are three settings:" and the Audio block page reads "There are four settings:", the extra being "Browser default – Use settings from site visitor's browser." The docs differ; both are official.
Does Preload affect how long my video takes to upload? No — it is a playback option on the published page. Upload behaviour is a separate matter; see WordPress video file too large to upload if the upload itself is failing.
Will preload settings help if my video is huge? Only by delaying the pain. WordPress's own guidance is that smaller or compressed videos load faster for viewers, so shrink the file first, then choose the setting.
Can I add captions to the same block? Yes — the Video block's Text tracks option displays "timed text tracks (such as subtitles or captions)", and the docs specify that "The tracks are formatted in WebVTT format (.vtt files or Web Video Text Tracks)." If your captions are SRT, SRT to VTT converts them in the browser.
Quotes above come from the WordPress Video block, Audio block and WordPress.com support documentation, checked 16 September 2026. More walkthroughs live in the how-to guides; every browser-side compressor and converter is in all Clapr tools.
