Support Home > Photos and Videos > Add a VideoPress video using the Block Editor

Add a VideoPress video using the Block Editor

Insert your videos directly into posts and pages on your website; they’ll be automatically uploaded to VideoPress hosting.

Using the the VideoPress block requires an active Jetpack Complete or VideoPress plan. If you are using the Classic Editor plugin, please refer to this guide instead: Add a Video Using the Classic Editor.

Insert the VideoPress block into a post or page

  1. Add the VideoPress block by searching for and selecting it within the block selector on a post or page on your site. Alternatively, you can type /videopress directly into the content of the page or post, then select the block from the drop-down that appears. To unlock all VideoPress features, please be sure to select the VideoPress block and not the Video block.
Screenshot of the block selector dropdown options. When searching for videopress, both the VideoPress block and the Video block will show up. Choose `VideoPress`
Adding the VideoPress Block from the block selector.

Select a video

  1. Drag your video directly to the block within your post or page to upload it. Alternatively, you can use one of the three options: Upload, Media Library, or Insert from URL. Each option is outlined below:
  • Upload: Upload a new video file from your computer. See our article Uploading a Video to Jetpack VideoPress for recommendations on file size and format for your videos.
  • Media Library: Select any VideoPress file that’s already been uploaded to your library.
  • Insert from URL: Insert the video URL directly.
  1. Once the video successfully uploads, you’ll see the ‘Upload complete!’ notification. When you are happy with your Video Title and Thumbnail, click Done and you’ll see your video embedded into your post or page. From there, you’ll be able to set a caption for your video and access the Block Toolbar.

Adjust your video’s settings

  1. Access video settings options either from the Block toolbar or the block’s sidebar settings for maximum control over how your video plays, and for whom. These different settings areas are outlined below.

Block toolbar

Use the the VideoPress block toolbar to adjust the video’s alignment on the page, change the video’s poster image, and add text tracks (captions or subtitles).

Videopress block toolbar, showing three icons: alignment, image, text tracks.
A screenshot of the VideoPress block toolbar.

Edit poster image

Editing the poster image for your video changes the thumbnail image that will be displayed before a video is played. The ability to modify this image helps choose an appealing image that’s most indicative of the video’s 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 x 1080 pixels.

Block settings

Every WordPress block has options available in the editor sidebar. If you do not see the sidebar, click the ‘cog’ icon next to the Publish button, and it will appear. These settings include adjusting how your video plays for visitors (playback settings), progress bar color customization, and privacy options.

Publish button, with the cog wheel next to it, opening up the Block settings.
A screenshot of where to find the WordPress Block editor settings on a post or page

In the Block settings, you will find the following options for your VideoPress block:

  • Title and description
  • Playback settings
  • VideoPress progress bar colors
  • Privacy and rating
  • Advanced CSS classes

More on each of these settings below.

Title and Description

Add a title and description for your video, to improve SEO (search engine optimization) and accessibility.

You can also use the Description box to add chapters to your video.

Playback Settings

  • Autoplay: 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: Choose if the video repeats automatically after it plays through. 
  • Muted: Choose if the video has sound when it plays. Users can still unmute the video from the player controls. It’s recommended to use the muted option if you choose to have your video autoplay.
  • Show Controls: Show or hide the playback controls on the video. This option is turned on by default.
  • Play Inline: Play your video inline within the element’s playback area. Not selecting this option doesn’t mean that your video will always be played fullscreen.

VideoPress Progress Bar Colors

You can use the Color settings to control the color of the progress bar in the VideoPress player.

VideoPress will automatically default to the Dynamic color setting, which will allow the progress bar to adapt to the video as it plays. If you toggle off Dynamic color, you’ll be presented with three color sections to change: Main, Loaded, and Progress.

After you select your desired Progress Bar colors, the player on the page will update automatically, allowing you to preview the colors you have selected before publishing or updating a page or post. When you publish or update your page or post, these color changes will be live on your selected video.

Privacy and Rating

  • Rating: Select a rating for the video, based on its content.
  • Privacy: Decide who gets to see your videos: site members only (private), or all visitors to your site (public). For more information, check out our VideoPress: Privacy article.
  • Allow Download: Control whether the VideoPress player should include the option for users to download the video.


Here you can add a CSS class to your block, so you can write custom CSS and style the block as you see fit.

The VideoPress video player is embedded in an iframe, meaning it’s not possible to style the video player itself. Only the <div> which contains the video player can be styled with CSS.

You can also add an HTML anchor to the block, to create a link directly to that section of the page.


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

Still need help?

Please contact support directly. We’re happy to advise.

  • Table Of Contents

  • Categories

  • Contact Us

    Need more help? Feel free to contact us.