Blogging & content · Info
WordPress Image Size Settings Explained: What Each Option Does

Short answer
WordPress image size settings live under Settings, then Media, and set the maximum dimensions for the thumbnail, medium and large copies made at upload. Defaults are 150, 300 and 1024 pixels, and changes only apply to new uploads unless you regenerate thumbnails.
Key takeaways
- Thumbnail defaults to a cropped 150 by 150 pixel square.
- Medium and large are maximum boxes that keep the image's shape.
- WordPress also makes hidden 768, 1536 and 2048 pixel sizes.
- Uploads over 2560 pixels are scaled down by default.
- New settings do not resize old images without regeneration.
- Themes and plugins often add their own image sizes.
What are the WordPress image size settings?
They are the options under Settings, then Media, that set the maximum dimensions for the thumbnail, medium and large copies WordPress creates every time you upload an image.
When you upload a photo, WordPress keeps the original and generates several smaller copies. Themes and the block editor then use the copy that best fits the space.
The Media settings screen lets you control three of those sizes. A few more exist behind the scenes, added by WordPress core, your theme or plugins.
The official Settings Media Screen documentation describes each field. This guide explains what each option actually does and when to change it.
What does each setting on the Media screen do?
The screen has three size fields, thumbnail, medium and large, plus a crop option for thumbnails and a checkbox that organizes uploads into year and month folders.
| Setting | Default | What it does |
|---|---|---|
| Thumbnail size | 150 by 150 pixels | Square copy, cropped by default |
| Crop thumbnail to exact dimensions | Checked | Crops instead of scaling proportionally |
| Medium size | Max 300 by 300 pixels | Scaled copy, keeps proportions |
| Large size | Max 1024 by 1024 pixels | Scaled copy, keeps proportions |
| Organize uploads into folders | Checked | Stores files in year and month folders |
The width and height values for medium and large are maximums. WordPress shrinks the image until both sides fit inside the box, keeping the original shape.
What does the thumbnail setting control?
It sets the size of the smallest copy, which themes often use for post lists, widgets and gallery grids, and by default it crops images to an exact square.
With crop on, a wide landscape photo is trimmed at the sides to make a 150 by 150 square. With crop off, WordPress scales the photo so it fits inside 150 by 150 without cutting anything.
Turn crop off if your thumbnails keep cutting off heads or products. Leave it on if your layout needs uniform squares.
Note that many themes register their own thumbnail size for featured images. That size may matter more than this setting. Our guide on setting a featured image covers how themes use those images.
What are medium and large sizes used for?
Medium suits images placed inline next to text, and large suits images that fill the content width; the editor offers them as resolution choices in the Image block.
When you insert an image, the block editor lets you choose Thumbnail, Medium, Large or Full Size in the block settings. That choice picks which file loads.
A good rule is to set Large to roughly the width of your content column, or a little more for sharp screens. If your content area is 800 pixels wide, a large size around that width avoids loading a much bigger file than needed.
Our guide on how to properly size images in WordPress shows how to measure your content width.
Which image sizes are hidden from the Media screen?
WordPress also creates a medium large size 768 pixels wide, plus 1536 and 2048 pixel sizes for high resolution screens, and these do not appear on the settings screen.
These extra sizes support responsive images. WordPress adds them to the image's srcset attribute, and the browser picks the best file for the screen.
- medium_large: 768 pixels wide, used mainly in srcset.
- 1536x1536: for large and high density displays.
- 2048x2048: for very large or retina screens.
Themes and plugins can add more with the add_image_size() function. A page builder, a WooCommerce store and a theme together can easily create ten or more copies of every upload.
Our guide on adding theme support in WordPress covers how themes declare features like post thumbnails.
What is the big image threshold?
Since WordPress 5.3, uploads larger than 2560 pixels on their longest side are scaled down to that size, and the scaled version is used as the main image.
WordPress keeps the original file too, and the scaled copy gets -scaled added to its file name. The change was explained in the core team's post on handling big images in WordPress 5.3.
There is no setting for this on the Media screen. Developers can change or disable the threshold with the big_image_size_threshold filter.
For most sites the default is sensible. Photographers who need full-resolution files on the page are the main exception.
Does changing the settings resize old images?
No; new sizes only apply to images uploaded after the change, so you must regenerate thumbnails to update existing uploads.
This surprises many people. They change the large size, reload a post, and see no difference.
To rebuild older images, use a tool such as the Regenerate Thumbnails plugin or the WP-CLI media regenerate command. Both create new copies at the current sizes.
Take a backup first on large media libraries, and run regeneration at a quiet time, since it uses server resources. If copies fail to appear, our guide to fixing thumbnails not generating covers memory limits and image library problems.
What does the uploads folder option do?
When checked, WordPress stores uploads in year and month folders such as 2026 then 11; when unchecked, every file goes into one uploads folder.
Year and month folders keep large libraries tidy and avoid very large single directories, which some servers handle slowly.
The setting only affects new uploads. Existing files stay where they are, and their URLs do not change. Most sites should leave it checked.
Should you set any size to zero?
Setting a size's width and height to zero stops WordPress from creating that copy, which saves disk space if your theme never uses it.
For example, if your theme never displays the medium size, setting it to 0 by 0 skips that file for future uploads.
Some themes, plugins and the editor's resolution menu rely on these sizes. Removing one can make images look blurry or oversized in places you did not expect.
Test on a staging copy first.
What settings work well for most sites?
Keep the defaults for thumbnail and medium, set large to about your content width, and focus on compressing images and serving modern formats.
Image size settings decide dimensions, not file weight. A 1024 pixel JPEG can still be heavy if it is saved at high quality.
For faster pages, combine sensible sizes with:
- Compression before or during upload.
- Modern formats such as WebP or AVIF. See our guide on serving images in next-gen formats.
- Lazy loading for images below the fold.
Our guide on optimizing images for WordPress brings these steps together. The Learn WordPress lesson on Media settings is also a helpful walkthrough of the screen.
Where else do image sizes come from?
Your theme, WooCommerce and many plugins register their own sizes, which you usually control in their settings rather than on the Media screen.
WooCommerce, for instance, has its own product image settings in the Customizer. Page builders may add sizes for galleries and sliders.
If your uploads folder has many more copies than you expect, a plugin is probably registering sizes. Some image management plugins can list every registered size so you can see where each one comes from.
Frequently asked questions
What are the default WordPress image sizes?
The Media screen defaults are a 150 by 150 pixel cropped thumbnail, a medium size up to 300 by 300 pixels and a large size up to 1024 by 1024 pixels. WordPress also creates a 768 pixel medium large size and 1536 and 2048 pixel sizes for high resolution screens.
Why did changing image sizes not affect my old images?
WordPress only creates resized copies at upload time. Existing images keep the copies made when they were uploaded. To apply new sizes to old images, run a thumbnail regeneration tool or the WP-CLI media regenerate command, ideally after taking a backup.
Why does WordPress add scaled to my image file names?
Images larger than 2560 pixels on their longest side are scaled down when uploaded, and the smaller copy gets scaled added to its name. WordPress uses that copy as the main image while keeping the original file. Developers can change the limit with a filter.
Should I turn off thumbnail cropping?
Turn it off if your thumbnails cut off important parts of photos, such as faces or products. Leave it on if your layout needs uniform square images in grids. Remember that the change only affects future uploads unless you regenerate thumbnails.
Do image size settings make my site faster?
They help by letting pages load smaller files instead of full-size uploads. But dimensions are only part of the picture. Compression, modern formats such as WebP and lazy loading usually make a bigger difference to page weight and loading speed.
Sources
- Settings Media Screen WordPress.org Documentation
- add_image_size() WordPress Developer Resources
- big_image_size_threshold WordPress Developer Resources
- Introducing handling of big images in WordPress 5.3 Make WordPress Core
- Regenerate Thumbnails WordPress.org
- Managing Settings: Media Learn WordPress
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.


