VideoPress is a lightweight and responsive video player that allows you to host and embed videos on your site.

This feature is available on sites with our WordPress.com Pro plan. If your site has one of our legacy plans, this feature is available on Premium, Business, and eCommerce.

Table of Contents

About VideoPress

VideoPress works on all modern browsers and devices and ensures beautiful playback on any screen size, from smartphones to desktops.

Please review the VideoPress Service Guidelines for a few basic expectations about how our service is intended to be used.

The VideoPress player is simple, unbranded, and ad-free. It places the focus on your content, so it can shine! Here is an example of the embedded player in action:

The VideoPress player includes picture-in-picture on supported web browsers. This means you can float the video into a corner of your browser tab and play it while you continue to scroll on the page or perform other tasks.

To use picture-in-picture mode, click on the icon in the lower right corner of the video player (it looks like a square with a smaller square in the corner):

The picture-in-picture option is located in the lower right corner of the video

↑ Table of Contents ↑

Video Requirements and Specifications

VideoPress supports MP4 (.mp4, .m4v), QuickTime movies (.mov), Windows Media Video (.wmv), Audio Video Interleave (.avi), MPEG (.mpg), Ogg (.ogv), 3GPP (.3gp) and 3GPP2 (.3g2). However, for best results and highest compatibility with other WordPress editor blocks (other than the Video block) please see our Recommended Video Settings.

VideoPress converts your uploaded video file into the MP4 format. Our MP4 files are encoded with H.264 video and AAC audio lossy compression codecs.

VideoPress works well for files up to 1GB. However, the larger the file, the more likely it is that the upload process will fail. Most networks will time out before you’re able to upload a file that’s larger than 1.4 GB. It’s best to compress your videos to a smaller size to optimize for web viewing.

The maximum possible upload size is 6GB, or 2GB if you have a plugin-enabled site. However, you may upload larger files via SFTP.

Videos uploaded that are over three hours will be converted to standard resolution but won’t be available in any higher resolution formats.

All files are optimized for progressive loading, enabling viewers to play your video while it downloads.

↑ Table of Contents ↑

Upload a Video

  • You can upload a video directly to any page or blog post on your site by dragging and dropping a video from your computer to your post or page editor.
  • You can also use the Video block and choose to upload a video from your computer. See this guide for more information.

Note that a slow or unreliable internet connection can further limit the size of the video you can upload. If you are having trouble, try uploading at a different time of day or from a computer with a faster internet connection. Keep trying (don’t worry, failed attempts don’t count against your storage space limit).

If you are dragging from iPhoto and the file generates an error or doesn’t fully upload, make sure you have the most recent versions of iPhoto, your browser, and your operating system installed. Alternatively, if you have trouble with the upload, try dragging the file from iPhoto to your desktop, then from your desktop into your media library, post, or page.


You may see a message saying “Your video is being processed”. Behind the scenes, VideoPress is creating new video files based on your upload for maximum compatibility with popular forms of playback. We also duplicate your video across our many data centers for maximum availability and accessibility.

↑ Table of Contents ↑

VideoPress Sharing Settings

VideoPress makes video playback and sharing a simple experience for your viewers through our default sharing options. Using the share links, viewers can easily share and embed your videos. By default, clicking on the Share button in the video player reveals the following sharing options:

This will give anyone viewing your videos the option to copy the video permalink or iframe embed code.

Disable Video Sharing

You can disable sharing for an individual video as below:

  1. In your dashboard, go to Media and locate the video.
  2. Click on it once, and then click Edit.
  3. On the right side of the video, you can check or uncheck the boxes for:
  • Display share menu and allow viewers to copy a link or embed this video
  • Display download option and allow viewers to download this video
The sharing options are highlighted in an orange box.

If your site has no plugins installed, you can also disable sharing for all uploaded videos.

  1. Go to Settings → Media and scroll down to the Video Player section.
  2. Uncheck the box for Share embed codes and download links:
Video Player settings

You can also turn off sharing while you are adding a video to a post or page by unchecking the option to display sharing options in the video player.


Disabling sharing removes the functionality, but it is still possible to download the video from your browser. We take reasonable steps to prevent embedding on other sites by hiding the sharing options, and that will stop most attempts.

↑ Table of Contents ↑

VideoPress Stats

All VideoPress videos come with stats tracking which can be viewed from the Stats screen in your dashboard.

VideoPress video stats.

For a more detailed breakdown of your video stats, click the arrow on the right of the Videos header pictured above. On the next screen, you’ll see the details below:

VideoPress video stats breakdown of Impressions, Hours Watched, and Views.
  • Impressions: The number of times a video was loaded on a page.
  • Hours Watched: The total number of hours that the video has been watched by all viewers.
  • Views: These are counted when a visitor actually clicks the play button on the video player.

Clicking on the name of a video from the Video section of the main Stats screen will display a chart showing daily activity for that video. It will also list the URLs where the video has been embedded.

VideoPress Video Details.

↑ Table of Contents ↑

Resize a Video

VideoPress automatically chooses the best player size for your site’s content column. If your default content width is 640 pixels the following video is displayed:

For greater control over the width of the video player, you can use a Shortcode block and take the following steps.

  1. Go to My Site → Media and click on the video you want, then click Edit.
  2. Copy the shortcode by clicking the Copy button as shown in the image below. It will start with the [ symbol, followed by wpvideo or videopress, a string of characters, and a closing ] symbol.
The shortcode is highlighted in orange
Copy the video shortcode from Media
  1. In the post or page that you want to show this video on, add a Shortcode block.
  2. Paste the shortcode from step 2, then use w=XXX before the end bracket to specify the width in pixels, like this:

[wpvideo OcobLTqC w=400]

You may set video width to a larger or smaller size, as long as it fits the width of your theme’s post column.

What attributes does the shortcode support?

The shortcode can accept a number of attributes to modify the default behavior. You can use the ones you’d like in this format [wpvideo OcobLTqC attribute=value], so for example [wpvideo OcobLTqC w=640 h=400 autoplay=true html5only=true].

  • w=X for width in pixels, do not include units
  • h=Y for height in pixels, do not include units
  • hd=true/false to force HD playback
  • freedom=true/false to force only use open-source video formats
  • autoplay=true/false to automatically play the video when it loads
  • loop=true/false to automatically play the video over and over

↑ Table of Contents ↑

Choose a Thumbnail

To choose the thumbnail for a video that is uploaded to our VideoPress service:

  1. In your dashboard, go to Media
  2. Select the video you want, then click the edit button.
  1. Select Edit Thumbnail
  1. Scroll through the video until you find the frame you want, then select Select Frame. Alternatively, you can choose Upload Image to choose an image you’ve created on your computer.

↑ Table of Contents ↑

Private Videos

Videos that are contained on a Private Site or explicitly flagged as private will only be accessible from within the content of the site itself to authenticated site visitors. If you receive an “Unauthorized” message, please ensure you are signed in with an account that has access to the site where the video was uploaded to.

An “Unauthorized” message may also appear if a video has been blocked due to a violation of our Terms of Service.

Changing a Video’s Privacy Setting

You can change a video’s privacy setting by setting the value of the Privacy dropdown in the Video block or directly on the video from the Media Library. Both locations set the global privacy value for the video.

Privacy options for a VideoPress Video
  1. Site Default: The video will have the same privacy as the site it is uploaded to
  2. Public: The video will be public, regardless of the privacy of the site it is uploaded to
  3. Private: The video will be private, regardless of the privacy of the site it is uploaded to. This is useful for sites with a public homepage where the site owner only wants to offer videos to members of the site

↑ Table of Contents ↑

Add Text Tracks for Subtitles and Captions

You can add Text Tracks (subtitles, captions, etc) to help with the 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 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:

↑ Table of Contents ↑

Downgrading Your Plan

If you downgrade your plan in the future, none of your existing video uploads will be removed from your site. They will remain embedded in any existing pages or posts you have; however, you will not be able to upload any new videos unless you renew or re-purchase the upgrade. Videos that you already uploaded will remain accessible.

Still confused?

Contact support.

Not quite what you're looking for?

Get Help