Blogging & content · Guide
How to Resize Video in WordPress (Step by Step)

Short answer
WordPress videos fill the width of their container, so you resize them by changing that container. Use the block's alignment, wrap the Video or Embed block in a Group with a set content width, or place it in Columns. For exact control, add a CSS class with a max-width rule.
Key takeaways
- Videos scale to fill their container and keep their aspect ratio.
- Alignment, Group widths and Columns change the player size.
- Custom CSS with max-width and aspect-ratio gives exact control.
- The classic video shortcode accepts width and height values.
- Re-encode large files to shrink them before uploading.
How do you resize a video in WordPress?
Place the Video or Embed block inside a Group or Column with a set width, or change the block's alignment, and the video scales down while keeping its shape.
WordPress videos are responsive by default. They stretch to fill the width of the area they sit in, and the height follows automatically.
That means you usually resize a video by changing its container, not the video itself. A narrower column gives a smaller player.
There is a second meaning of resize too: shrinking the video file before you upload it. Both are covered below, starting with the on-page size.
What controls the size of a video on the page?
The width of the content area, the block's alignment and any container around it decide how big the player appears, and the height adjusts to keep the original aspect ratio.
Your theme sets a content width, often somewhere around 600 to 1200 pixels. A video in a normal post fills that width.
Wide and full-width alignment let a video go beyond the content area, if your theme supports them. Left and right alignment shrink it and let text wrap beside it.
Here is a quick comparison of the main ways to change the size:
| Method | Works for | Effect |
|---|---|---|
| Block alignment (wide, full, left, right) | Video and Embed blocks | Larger or smaller player using theme sizes |
| Group block with a content width | Any block | Sets an exact maximum width |
| Columns block | Any block | Splits the row so the video takes a share |
| Custom CSS class | Any block | Precise control on every screen size |
| Video shortcode width and height | Classic editor | Fixed player size in pixels |
| Re-encoding the file | Uploaded videos | Smaller file and resolution, not player size |
How do you resize a Video block?
Select the Video block, use the alignment button in its toolbar to make it wider or narrower, or wrap it in a Group block and set a content width in the sidebar.
The core Video block plays files from your Media Library. It does not have a simple width slider in every version, so alignment and containers do most of the work.
To set an exact size with a Group:
- Select the Video block and open its Options menu.
- Choose Group to wrap it.
- With the Group selected, open the Layout settings in the sidebar.
- Turn on the option for inner blocks to use content width, then enter a width such as 640px.
- Center the Group if you want the smaller player in the middle.
The exact labels can shift between WordPress releases. If you do not see them, check that your theme supports layout settings, which most block themes do.
Our guide on how to make a block smaller explains these layout controls for every kind of block.
How do you resize a YouTube or Vimeo embed?
Embeds are resized the same way as the Video block: change the alignment, place them in a narrower Group or Column, or set a width with custom CSS.
When you paste a YouTube link, WordPress creates an Embed block. The YouTube embed documentation shows its settings.
The Embed block has a Resize for smaller devices toggle in the sidebar. Leave it on so the player keeps its aspect ratio on phones.
If an embed looks squashed or has black bars, the aspect ratio setting may be off. Turning the resize toggle off and on again often resets it.
Embedded players also load extra scripts. Our guide on speeding up YouTube embeds covers lazy loading and lighter players.
How do you put a video next to text?
Use a Columns block or the Media & Text block, put the video in one column and text in the other, then adjust the column widths to make the video bigger or smaller.
The Columns block lets you set each column's width as a percentage. A 40/60 split gives a smaller video beside a larger block of text.
Media & Text pairs a video or image with text in one block. You can drag the divider to change how much space the video takes.
On phones, both blocks usually stack the columns, so the video goes back to full width. That is normally what you want on a small screen.
How do you resize a video with CSS?
Add a custom CSS class to the block, then write a rule that sets a maximum width and keeps the aspect ratio, so the player stays the same shape on every screen.
Open the block's Advanced panel in the sidebar and add a class name, for example small-video.
Then add CSS through Appearance > Editor > Styles in a block theme, or Appearance > Customize > Additional CSS in a classic theme:
.small-video {
max-width: 560px;
margin-left: auto;
margin-right: auto;
}
.small-video iframe,
.small-video video {
width: 100%;
height: auto;
aspect-ratio: 16 / 9;
}
The aspect-ratio property keeps embeds from collapsing. MDN's reference on CSS aspect-ratio explains how it works and which browsers support it.
If you are new to adding code, our guide on adding code to WordPress shows safe places to put CSS.
How do you resize a video in the classic editor?
In the classic editor, add width and height values to the video shortcode, or edit the embed's size in the media settings, to set a fixed player size.
WordPress inserts uploaded videos with the [video] shortcode. It accepts width and height attributes, which the wp_video_shortcode reference lists along with other options.
For example, [video width="640" height="360" mp4="your-file.mp4"] sets a 640 by 360 player. Keep the ratio the same as the original file.
The player will not grow beyond the theme's content width, even if you enter bigger numbers. This stops videos from breaking the layout.
How do you reduce a video's file size before uploading?
Re-encode the video at a lower resolution or bitrate with a tool such as HandBrake, then upload the smaller file so it loads faster and fits your host's upload limit.
A phone video recorded in 4K can be hundreds of megabytes. Most website players never show it at that size.
Exporting at 1080p or 720p with a modern codec usually cuts the file down a lot with little visible loss. The HandBrake documentation explains its presets for web video.
Large uploads can also fail with errors. Hosts set a maximum upload size, which appears on the Media > Add New screen. If uploads keep failing, our guide to HTTP errors when uploading covers the usual limits.
Should you host videos on your own site at all?
For most sites, hosting large videos on YouTube or Vimeo and embedding them is lighter on your server than uploading files to WordPress.
Self-hosting gives you full control and no third-party branding, but every view uses your bandwidth.
Our comparison of self-hosting videos versus embedding YouTube weighs speed, cost and control.
Why is my WordPress video too big or not resizing?
A video that will not resize usually has a fixed width in its code, sits in a container that ignores layout settings, or is affected by theme or page builder CSS.
Check these in order:
- Fixed size in HTML: Embeds pasted as raw iframe code often include width and height. Remove them or use the Embed block instead.
- Full-width alignment: A video set to full width will fill the screen. Switch to none or wide.
- Theme CSS: Some themes force videos to 100 percent width. A custom class with a max-width rule overrides this.
- Page builder settings: Elementor and similar builders have their own video widget size controls, separate from the block editor.
- Cache: After changing CSS, clear your caching plugin and browser cache before checking again.
Always check the result on a phone. Our guide on adjusting WordPress for mobile explains how to preview and fix layouts on small screens.
What video size works best on a WordPress page?
A 16:9 player that fills the content width works for most posts, while smaller embeds of around 480 to 640 pixels suit sidebars and text-heavy pages.
Keep the original aspect ratio. Forcing a 16:9 video into a square box adds black bars or crops the picture.
For short clips and product demos, a smaller player beside text often reads better than a huge one. For tutorials and talks, give the video room so viewers can see details.
Whatever size you choose, test playback on desktop and mobile, and check that captions and controls stay usable.
Frequently asked questions
How do I make a video smaller in WordPress?
Wrap the Video or Embed block in a Group block and set a content width in its layout settings, or place it in a narrower column. You can also add a CSS class with a max-width rule for exact sizing.
How do I make a YouTube video full width in WordPress?
Select the Embed block and choose wide or full width alignment from its toolbar, if your theme supports it. Keep the resize for smaller devices option on so the player keeps its shape.
Can I set video width and height in WordPress?
In the classic editor you can add width and height values to the video shortcode. In the block editor, set the width through a Group block or custom CSS, and let the height follow the aspect ratio.
Why is my embedded video not responsive?
It may have been pasted as raw iframe code with fixed width and height values. Use the Embed block instead, or remove those values and add CSS with width 100 percent and an aspect ratio.
How do I compress a video for WordPress?
Export it at 1080p or 720p with a lower bitrate using a free encoder such as HandBrake before uploading. Smaller files load faster and are less likely to hit your host's upload limit.
Sources
- Video block WordPress.org Documentation
- YouTube embed WordPress.org Documentation
- wp_video_shortcode() WordPress Developer Resources
- aspect-ratio MDN Web Docs
- HandBrake Documentation HandBrake
Is your product missing, or something out of date?
Tell us what to add or correct. We read every note and reply when we need a source. A message does not buy a ranking.
Thanks — we review requests within 3 business days.
Related guides
About the editors
Researched from the primary sources listed above and checked against our editorial rules before publishing.


