Blogging & content · Guide
How to Set Image Size in WordPress (Step by Step)

Short answer
To set an image's size in WordPress, select it in the block editor, choose a Resolution in the block settings and set a width or drag the handles. To change the thumbnail, medium and large sizes WordPress creates on upload, go to Settings, then Media, and save new values.
Key takeaways
- Display size, generated sizes and original dimensions are set in different places.
- Settings > Media controls thumbnail, medium and large sizes.
- The Image block's Resolution option picks which file loads.
- New sizes only apply to old images after regenerating thumbnails.
- Featured image size is controlled by your theme.
How do you set image size in WordPress?
Select the image in the block editor and pick a Resolution in the block settings, then set width and height or drag the handles; to change the sizes WordPress creates on upload, edit Settings > Media.
There are really three different things people mean by image size in WordPress:
- The display size of one image in a post or page.
- The file sizes WordPress generates when you upload, such as thumbnail and medium.
- The original dimensions of the file you upload.
Each is set in a different place. This guide covers all three, plus the theme and developer settings that override them.
If you are here because PageSpeed Insights flagged your images, read our guide to fixing properly size images after this one.
What image sizes does WordPress create automatically?
When you upload an image, WordPress saves the original and creates several smaller copies at preset sizes, which themes and the editor then use.
| Size name | Default maximum | Where it is set |
|---|---|---|
| Thumbnail | 150 x 150 px, cropped | Settings > Media |
| Medium | 300 x 300 px | Settings > Media |
| Large | 1024 x 1024 px | Settings > Media |
| Medium large | 768 px wide | Core, not shown in settings |
| 1536 and 2048 | 1536 and 2048 px | Core, for high-resolution screens |
| Full | Your uploaded size, or scaled to 2560 px | Original upload |
The medium and large sizes keep the image's proportions within those limits. Thumbnails are cropped to an exact square unless you turn cropping off.
Themes and plugins often add their own sizes on top, such as a blog card size or a WooCommerce product size. That is why one upload can create many files.
How do you change the default sizes in Settings > Media?
Go to Settings > Media, enter new width and height values for Thumbnail, Medium and Large, decide whether thumbnails should be cropped, and click Save Changes.
Steps:
- In wp-admin, open Settings > Media.
- Under Image sizes, change the thumbnail width and height.
- Tick or untick Crop thumbnail to exact dimensions.
- Change the maximum width and height for Medium and Large.
- Click Save Changes.
The Settings Media screen documentation describes each field.
These values only apply to images you upload from now on. Existing images keep their old copies until you regenerate them, which is covered later.
A value of 0 for a height means no limit, so WordPress scales by width only. That is handy for tall images such as infographics.
Think about your layout before changing these numbers. If your content column is 800 pixels wide, a Large size of 1024 pixels covers it on most screens, while a Medium size around 400 pixels suits half-width images.
Avoid making Medium and Large almost the same. Sizes that are too close waste storage without giving the browser a useful choice.
How do you set the size of an image in a post or page?
Click the image block, open the block settings sidebar, choose a Resolution such as Medium, Large or Full Size, then set a width or height, or drag the blue handles on the image.
In the block editor, the Image block settings give you several controls:
- Resolution picks which generated file is loaded, such as Large or Full Size.
- Width and Height set the displayed size in pixels or other units.
- Aspect ratio crops the display to shapes such as square or 16:9 in newer versions.
- Scale decides whether a cropped image covers or fits the box.
Resolution matters for speed. Choosing Full Size for a small image makes visitors download a large file only to show it small.
A good rule is to pick the smallest resolution that is still at least as wide as the space the image fills. On a typical blog column, Large is usually right.
How do you resize with the drag handles?
Click the image and drag a handle on its edge or corner; the width and height fields update as you drag, and the image keeps its proportions.
Hold the alignment in mind too. Left or right aligned images float beside text, so they usually need a smaller width than centred or wide images.
For layout tweaks beyond images, see how to make a block smaller in WordPress.
How do you set image size in the classic editor?
Click the image, then the pencil icon, and choose a size from the Size dropdown under display settings, or select a custom size and type the width and height.
You can also pick the size when inserting, in the Attachment display settings panel on the right of the media window.
How do you set image size in page builders?
Page builders such as Elementor have their own image widget with an image size dropdown and width controls, which work much like the block editor's options.
Pick a registered size from the dropdown rather than Full where you can. Then use the width slider for the display size on each device.
How do you change the actual dimensions of an uploaded image?
Open the image in the Media Library, click Edit Image, enter new dimensions under Scale Image, click Scale, and save; WordPress replaces the original with the smaller version.
This is useful when you uploaded a huge photo straight from a camera. Scaling it down saves storage and stops it being served at full size by mistake.
The same editor lets you crop, rotate and flip. WordPress keeps a copy of the original, and Restore image brings it back if you change your mind.
Even better, resize images before you upload. Exporting photos at around 2000 pixels wide is plenty for most sites, and our guide to optimising images for WordPress covers compression too.
What is the big image threshold?
Since WordPress 5.3, very large uploads are automatically scaled down so their longest side is 2560 pixels, and that scaled copy is used as the full size.
The original is still kept on the server. Developers can change or disable the limit with the big_image_size_threshold filter.
If uploads fail before they even reach this step, our guide on increasing the maximum upload size can help.
How do you set featured image size?
Your theme decides the featured image size, so you change it through the theme's settings, the Site Editor in block themes, or code in a child theme.
In a block theme, open the template in the Site Editor, select the Featured Image block and adjust its width, height and aspect ratio.
In classic themes, check Appearance > Customize for blog or post layout options. If there are none, the theme sets the size in code with set_post_thumbnail_size.
Our guide on setting a featured image covers adding one in the first place.
How do developers add custom image sizes?
Use add_image_size in a child theme or plugin to register a new size with a name, width, height and crop setting, then regenerate thumbnails so existing images get it.
add_action( 'after_setup_theme', function () {
add_image_size( 'card-image', 600, 400, true );
} );
The last argument decides whether WordPress crops to the exact size. The add_image_size reference explains crop positions and other options.
Do not add sizes you will not use. Every extra size is another file created for every upload, which uses disk space and slows uploads.
How do you apply new sizes to old images?
Regenerate thumbnails with a plugin such as Regenerate Thumbnails or the WP-CLI media regenerate command, which rebuilds the generated copies for images already in your library.
The Regenerate Thumbnails plugin works from wp-admin. On large sites, the wp media regenerate command is faster and avoids browser timeouts.
Back up the uploads folder first on big libraries. If regeneration fails or thumbnails go missing, see our guide on fixing thumbnails not generating.
Does WordPress serve the right size to each screen?
Yes, mostly; WordPress adds srcset and sizes attributes to content images so browsers can choose a smaller generated copy on phones and a larger one on big screens.
That only works if the right copies exist and your theme tells the browser how wide the image will display. The web.dev guide to responsive images explains the idea.
You can see what the browser picked using developer tools. The MDN guide on responsive images shows how srcset and sizes work together.
For further gains, combine correct sizing with modern formats and lazy loading, covered in our guide to serving next-gen image formats.
Frequently asked questions
What are the default image sizes in WordPress?
WordPress creates a 150 by 150 pixel cropped thumbnail, a medium size up to 300 pixels and a large size up to 1024 pixels. It also makes hidden sizes for responsive images and scales very large uploads down to 2560 pixels.
Why did changing Settings > Media not affect my images?
Those settings only apply to images uploaded after you save them. Existing images keep the copies made at upload time. Run a thumbnail regeneration tool to rebuild the copies for older images.
Should I choose Full Size for images in posts?
Usually not. Full Size loads the largest file, which slows pages if the image displays smaller. Pick the smallest resolution that is at least as wide as the space, often Large for a standard blog column.
How do I stop WordPress cropping thumbnails?
Go to Settings, then Media, untick the option to crop thumbnails to exact dimensions and save. New thumbnails will keep their proportions. Regenerate thumbnails if you want older images updated too.
Can I resize an image without a plugin?
Yes. Use the Image block's width and resolution controls to change display size, or open the image in the Media Library, click Edit Image and use Scale Image to change its real dimensions. No plugin is needed for either.
Sources
- Settings Media Screen WordPress.org Documentation
- Image block WordPress.org Documentation
- add_image_size() WordPress Developer Resources
- big_image_size_threshold WordPress Developer Resources
- Serve responsive images web.dev
- Responsive images MDN Web Docs
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.


