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

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.

You can also use VideoPress as your own personal video hosting service. Rather than embedding videos from other supported websites on your site, VideoPress allows you to upload video in your site’s Media Library. You can embed or share your videos anywhere on the web — other websites, social media, chat services, etc. — by using a permalink or a snippet of code.

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 in supported web browsers, meaning you can pop the video out of the browser and watch it in a separate window. To use picture-in-picture, 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 or VideoPress 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.

Video hosting works well for files up to 1GB. However, the larger the file, the greater chance for the upload process to fail. Most networks will time out before you’re able to upload a file that’s larger than 1.4 GB. It’s wise 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 Business or eCommerce plan site with plugins installed. However, on the Business and eCommerce plan, 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 ↑

Enable VideoPress on Your Site

VideoPress is included with the WordPress.com Premium and higher plans. Once you have a supported plan active on your site, you are all set to start uploading and embedding videos!

On the WordPress.com Premium plan your videos count against your storage allotment of 13 GB. On Business or eCommerce plans with plugins installed, videos do not count against your storage allotment. You don’t have to worry about bandwidth.

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.

↑ 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 documentation 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, your viewers will be able to 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 share the video permalink or iframe embed code.

Disable Video Sharing

If you would like to disable sharing, you can do that in the video settings in the Media Settings. Go to My Site → Settings → Media and scroll down to the Video Player section:

Video Player settings

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

The video player settings
Video Player settings under Settings → Media


Disabling sharing removes 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 on your homepage.


Clicking on the name of a video will display a chart showing daily activity for the video. It will also list the URLs where the video has been embedded. Plays are counted when a visitor actually clicks the play button on the video player.


↑ 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 My Site → 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. Go to My Site → 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 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 will only be accessible from within the content of the site itself. If you receive an “Unauthorized” message, please ensure you are signed in with an account that has access to the site that 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.

↑ Table of Contents ↑

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.

Still confused?

Contact support.

Not quite what you're looking for?

Get Help