Support Home > Photos and Videos > Add a Video Using the Block Editor

Add a Video Using the Block Editor

The Video Block allows you to insert your Jetpack VideoPress videos into posts and pages on your website. To use the Video Block with Jetpack’s video hosting, your site should have an active Jetpack Complete or VideoPress plan.

Note: If you have disabled sharing on your video, you can still use the video block or the shortcode block to insert your video. If you are using the Classic Editor plugin, you will need to see our article on how to Add a Video Using the Classic Editor.

Insert the Video Block

You can add the video block by searching and/or selecting it from the block selector, or you can type /video on the page/post and select it from the drop-down that appears. Be sure to select the Video Block rather than the VideoPress block as they function differently.

Select a Video

You can add a video directly within the block itself by dragging the file to the block or using one of the three buttons: Upload, Media Library, and Insert from URL.

  • Upload will allow you to upload a new video file from your computer. You’ll see a progress bar where you can pause and resume the upload. See our article on Uploading a Video to Jetpack VideoPress for recommendations on file size and format for your videos.
  • Media Library allows you to select any video file that’s already been uploaded to your library, including those that have been uploaded to Jetpack’s video hosting.
  • Insert from URL allows you to insert any video URL, both from Jetpack’s video hosting and third-party services. If you insert a URL from another supported block type, such as YouTube, the Video block will automatically transform into a YouTube block.

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

Block Toolbar

The video block gives you the ability to change the video’s alignment on the page and edit the video being used in the block.

Change Alignment

By clicking the Change alignment button, you can change the video’s alignment to Align left, Align center, Align right, Wide width, or Full width.

Edit Video

The edit option in the video block’s toolbar will remove the currently selected video from the block. Once removed, you will have the option to select a new video from your computer, the media library, or from a URL.

Add Text Tracks for Subtitles and Captions

You can add Text Tracks (Subtitles, captions, etc) to help with accessibility and engagement of your video. To add a Text Track, create a .vtt formatted text file, then click the Text Tracks button in the video block’s toolbar. Add your .vtt file and enter the label, language code, and kind of the track. Click Save and your track will get added to the video. Preview your post and the subtitles menu will be available in the video player with your text track available as an option for a viewer to select:

Note that viewers can use the captions settings menu to customize the appearance of the subtitles or captions text to their liking.

Block Settings

The block settings can be found in the sidebar.

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.

Video Settings Toggles

This section of the sidebar lets you control several settings:

  • Autoplay: This option lets you set your video to automatically play when someone visits your page or post. Some browsers do not respect this setting. You may need to enable mute for autoplay to work in those instances.
  • Loop: This option allows you to choose if the video repeats automatically after it plays all the way through. 
  • Muted: This option allows you to choose if the video has sound when it plays. Users still have the ability to unmute the video from the player controls. It’s recommended to use the muted option if you choose to have your video autoplay.
  • Playback Controls: This option allows you to show or hide the playback controls on the video. This option is turned on by default.
  • Play Inline: This option allows ​​your video to be played inline, that is within the element’s playback area. However, not selecting this option doesn’t mean that your video will always be played fullscreen.


This option allows you to select how much of the video file is downloaded when the page or post is loaded. 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 setting will make sure that your page loads the most efficiently.
  • 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. While it may be tempting to go ahead and have the whole file downloaded automatically, keep in mind that this can slow your page’s load speed down.

Poster Image

Optionally, 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.

While there isn’t a minimum required size for your poster image, we recommend that the image be at least the size of your video. For example, if your video is a 1080p video, you should use an image that is 1920 by 1080 pixels.


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.

You can also add an HTML anchor to the block, which lets you link directly to that section of the page.

Video Stats

An overview of the overall video stats is available and can be found within the stats. You can scroll down and find the “Videos” stats:

Clicking on “Video” will take you to the page that shows more statistics:

Impressions: The number of times a video was loaded on the page.

Hours watched: The total number of hours that the video has been watched by all viewers.

Views: The total number of how many times the video was played.


If you’re having trouble with videos, please refer to the article on Uploading a Video to Jetpack VideoPress or Troubleshooting Video Hosting Issues.

Get help

Feel free to contact support for more personalized assistance.

Privacy Information

This feature is deactivated by default. It can be activated/deactivated at any time by toggling the Enable high-speed, ad-free video player” setting in the Video section at Jetpack → SettingsPerformance in your dashboard.

Data Used
Site Owners / Users

In order to track video plays for your stats, we will send the site ID, post ID (on which the video is played), and domain name of your site with these events.

If Google Analytics tracking is enabled, some video information (size, quality, format, file name, ID, etc.) will be sent there, as well.

Please refer to the privacy documentation for Stats and Google Analytics for more information on the data used to record video play tracking.

Site Visitors

Please refer to the privacy documentation for Stats and Google Analytics for more information on the data used to record video play tracking.

Activity Tracked
Site Owners / Users

Video plays.

We track when, and by which user, the feature is activated and deactivated.

Site Visitors

Video plays.

Data Synced (Read More)
Site Owners / Users

We sync options that identify whether or not the feature is activated and how its available settings are configured.

Site Visitors


  • Table Of Contents

  • Categories

  • Contact Us

    Need more help? Feel free to contact us.