Blocks

Blocks »Video Block

The video block allows you to upload and embed video into your post or page.

The video block is supported on the WordPress.com Premium, Business, and eCommerce plans. If you do not wish to upgrade, you can upload your video to a free service like YouTube and embed the video onto your site.

Table of Contents

A video block in action.
A video block in action.

Detailed instructions on adding blocks can be found here.


Adding a Video

When you add a video block you will be prompted with three options to add your content:

  • Upload: Allows you to upload a new video file from your computer.
  • Media Library: Lets you select a file that’s already uploaded to your site’s Media Library.
  • Insert from URL: Allows you to insert a URL from a supported block type, such as YouTube. The video block will automatically transform into a YouTube block.
Links added to the video block from external services will transform into their respective block.
Links added to the video block from external services will transform into their respective block.

Once the video is embedded in the page, you can add an optional caption if desired.


↑ Table of Contents ↑

Block Interface

Every block comes with unique toolbar icons and block specific user controls that allow you to manipulate the block right in the editor.

The video block toolbar supports alignment, wide, and full width.
The video block toolbar supports alignment, wide, and full width.

↑ Table of Contents ↑

Alignment

As with the image block, the video block can be inline-aligned with a the paragraph below it by clicking the left-align or right align icons.

If you wish for the video to be emphasized on the page, the Wide and Full Alignment options will expand the video beyond the bounding column of the page, providing a cinematic experience.


↑ Table of Contents ↑

Edit Video

The edit option in the video block’s toolbar will allow you to select a new video file for your block. Use this if you need to replace the video file in your video block.


↑ Table of Contents ↑

Every block has specific options in the editor sidebar in addition to the options found in the block toolbar. If you do not see the sidebar, simply click the ‘cog’ icon next to the Publish button.

The block settings can be found in the sidebar.
The block settings can be found in the sidebar.

The Video Block has the following options:

Autoplay will play the video automatically when the page is loaded, but only if supported by the browser. Some modern browsers block this feature.

Loop will make the video play again from the beginning as soon as it has ended.

Muted will play the video without sound.

Playback Controls will give the viewer a play button, volume controls, HD mode, playback speed, and full screen options.


↑ Table of Contents ↑

Preload

Preload 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. There are three settings:

  • 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 – Only basic info about the file will be downloaded automatically. Like the None option, the download of the video file only begins when someone clicks Play. This setting is also very fast, as the only thing downloaded is text. On a fundamental level, there’s not a big difference between None and Metadata.
  • 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.

↑ Table of Contents ↑

Poster Image

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.


↑ Table of Contents ↑

Advanced

The advanced tab lets you add a CSS class to your block, allowing you to write custom CSS and style the block as you see fit. Learn more.

The advanced section lets you add a CSS class to your block.
The advanced section lets you add a CSS class to your block.

↑ Table of Contents ↑

VideoPress

VideoPress is a lightweight and responsive video player that allows you to host and embed videos in your site and more. If you upload a video to a video block, or by dragging and dropping a video into your post or page, it automatically becomes hosted with VideoPress

See this documentation for more information.

Not quite what you're looking for?

Get Help