How to add a video player to WordPress

Decide whether the video should come from YouTube or Vimeo, your WordPress Media Library, or a dedicated video service. An external embed avoids uploading the file to your site, while a self-hosted video gives you more control but uses your site’s storage and bandwidth. WordPress supports both approaches through its built-in blocks.

For one or two ordinary videos, the built-in route is usually enough. Choose a dedicated player when you need branded controls, viewer analytics, playlists, calls to action, or interactive content.

Edit the post or page, select the + button, and search for Video. The block offers Upload, Media Library, and Insert from URL. You can also type /video in an empty paragraph to insert it quickly.

For YouTube, Vimeo, or another supported service, paste the video URL on its own line. WordPress can turn the URL into the matching embed block, so you do not normally need to copy iframe code.

Select the video block and open the settings sidebar. Keep the playback controls enabled, then choose a suitable alignment and width. Set a poster image if the first frame is not a useful preview. The poster image appears before playback starts.

Use autoplay sparingly. Browsers and mobile devices may block autoplay, especially when the video has sound, and device settings such as low-power mode can also prevent it. Do not make autoplay the only way visitors can start the video.

Use Add caption below the player for a short description. For timed subtitles or accessibility captions, open the block toolbar’s Text tracks option and upload a .vtt WebVTT file. Give the track a readable label, select its language, and choose the correct kind, such as Subtitles or Captions.

Preview the published page and turn the captions on from the player controls. A caption file that has invalid timings or an incorrect language setting may upload but fail to display correctly.

Save or publish the page, then check it in a private browser window on desktop and mobile. Confirm that the video loads, the controls work, the poster appears, and the captions can be selected. Also check the page without being logged in, because a private or restricted external video may be visible to you but unavailable to visitors.

If a self-hosted file fails, open its media URL directly. If it does not play there, replace or re-encode the file in a format supported by the visitor’s browsers. If an external embed shows a blank area, confirm that the source video is public or embeddable and paste its normal video URL rather than a private dashboard URL.

The built-in Video block is the fast, sensible choice for a basic player. If you need a more controlled presentation, install Presto Player from the WordPress admin area and configure its player settings before replacing your basic embeds. It is designed for WordPress sites that need custom skins, YouTube and Vimeo support, self-hosted videos, analytics, captions, playlists, and interactive elements.

Choose this route when those features justify an extra plugin. Keep the manual block instead for a simple video, because adding a plugin only to display one ordinary clip creates another component to maintain.