Guides/Create content/Media/Customize the VideoPress player

Customize the VideoPress player

Last reviewed on September 21, 2025

You can customize the VideoPress player to match your site’s design and control how your videos are presented. In this guide, you will learn how to adjust the player size, set a custom poster image, enable or disable playback features, and personalize the progress bar.

Video tutorial

Change the player size

To resize your VideoPress player directly in the WordPress editor, follow these steps:

  1. Click the VideoPress block to select it.
  2. Look for the resize handles (small squares) on the edges or corners of the video player.
  3. Click and drag a handle to adjust the width or height of the player to your preferred size.
  4. Release the mouse button to set the new size.
  5. Click Save or Publish to apply your changes.

Choose a thumbnail

The poster image is the thumbnail shown before your video plays. You can choose a frame from your video or upload a custom image.

  1. Select the VideoPress block, then open the block settings sidebar.
    • If you do not see the sidebar, click the Settings icon in the top-right corner.
  2. Under the Poster and Preview section, choose one of the following:
    • Pick from video frame: Scroll through the video timeline to select a frame as the poster image.
    • Select Poster Image: Upload a new image or select one from your Media Library.
  3. You can also toggle the option to display a “Video preview on hover” to allow visitors to scan your video content.
  4. Click Save or Publish to apply your changes.
The Poster and preview option of the VideoPress block settings sidebar.

💡

Use a poster image that is at least as large as your video’s resolution for best quality (for example, use a 1920 x 1080 image for a 1080p video).

Customize playback

You can control how your video plays and what options are available to viewers.

  1. Select the VideoPress block, then open the block settings sidebar.
    • If you do not see the sidebar, click the Settings icon in the top-right corner.
  2. Under Playback, adjust the following options:
    • Autoplay: Start the video automatically when the page loads.
      Reminder Some browsers may block autoplay unless the video is muted.
    • Loop: Play the video repeatedly.
    • Muted: Start the video with sound off. Viewers can unmute if desired.
    • Show Controls: Show or hide the playback controls (play, pause, volume, etc.).
    • Play Inline: Allow the video to play inline on mobile devices instead of full screen.
    • Preload: Choose how much of the video is loaded when the page loads (None, Metadata, Auto).
  3. Click Save or Publish to apply your changes.
The playback options in the VideoPress block settings sidebar.

Change the progress bar color

You can personalize the color of the progress bar to better match your video or site design.

  1. Select the VideoPress block, then open the block styles sidebar.
    • If you do not see the sidebar, click the Settings icon in the top-right corner.
  2. Dynamic color is enabled by default, which adapts the colors to the video as it plays.
  3. Disable the option to set the colors:
    • Main: The default color of the progress bar.
    • Loaded: The color of the bar once the video has loaded.
    • Progress: The color of the bar as the video is loading.
  4. Click Save or Publish to apply your changes.

Adjust padding and margins

Adjust the padding and margins around the VideoPress player through the dimensions settings of the block styles sidebar.

VideoPress shortcode

You can also insert a video and control its size using a shortcode, by following these steps:

  1. In your dashboard, click on Media.
  2. Click the video you want the shortcode for.
  3. Copy the provided shortcode by clicking the Copy button, as shown in the image below.
    • A VideoPress shortcode will start with the [ symbol, followed by wpvideo or videopress, a string of characters, and a closing ] symbol.
    • For example:

[wpvideo YN4MKhAB]

The bottom section of a video details page in Media, with the shortcode highlighted.
  1. Edit the post or page that you want to show this video on.
  2. Click the + block inserter and add a Shortcode block.
  3. Paste the shortcode from step 3, then add w=XXX before the end bracket to specify the width in pixels, like this:

[wpvideo YN4MKhAB w=400]

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

VideoPress shortcode attributes

The shortcode can accept the following attributes to modify the default behavior:

  • 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.
  • controls=false to hide the default video controls when displaying a video.

You can use the attributes you’d like by adding them before the closing ] symbol: [wpvideo OcobLTqC attribute=value]. For example:

[wpvideo OcobLTqC w=640 h=400 autoplay=true loop=true]

Was this guide helpful for you?

Not quite what you're looking for? Get Help!

Copied to clipboard!