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.
To resize your VideoPress player directly in the WordPress editor, follow these steps:
- Click the VideoPress block to select it.
- Look for the resize handles (small squares) on the edges or corners of the video player.
- Click and drag a handle to adjust the width or height of the player to your preferred size.
- Release the mouse button to set the new size.
- Click Save or Publish to apply your changes.
The poster image is the thumbnail shown before your video plays. You can choose a frame from your video or upload a custom image.
- 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.
- 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.
- You can also toggle the option to display a “Video preview on hover” to allow visitors to scan your video content.
- Click Save or Publish to apply your changes.

💡
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).
You can control how your video plays and what options are available to viewers.
- 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.
- 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).
- Autoplay: Start the video automatically when the page loads.
- Click Save or Publish to apply your changes.

You can personalize the color of the progress bar to better match your video or site design.
- 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.
- Dynamic color is enabled by default, which adapts the colors to the video as it plays.
- 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.
- Click Save or Publish to apply your changes.
Adjust the padding and margins around the VideoPress player through the dimensions settings of the block styles sidebar.
You can also insert a video and control its size using a shortcode, by following these steps:
- In your dashboard, click on Media.
- Click the video you want the shortcode for.
- 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
wpvideoorvideopress, a string of characters, and a closing ] symbol. - For example:
- A VideoPress shortcode will start with the [ symbol, followed by
[wpvideo YN4MKhAB]

- Edit the post or page that you want to show this video on.
- Click the + block inserter and add a Shortcode block.
- Paste the shortcode from step 3, then add
w=XXXbefore the end bracket to specify the width in pixels, like this:
[wpvideo w=400]YN4MKhAB
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.
The shortcode can accept the following attributes to modify the default behavior:
w=Xfor width in pixels, do not include units.h=Yfor height in pixels, do not include units.hd=true/falseto force HD playback.freedom=true/falseto force only use open source video formats.autoplay=true/falseto automatically play the video when it loads.loop=true/falseto automatically play the video over and over.controls=falseto 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]