WordPress glossaryThumbnail sizes are the resized copies WordPress makes of each uploaded image, such as thumbnail, medium, and large, so every spot gets a fitting size.
Every time an image is uploaded to WordPress, it saves the original and then creates several smaller copies of it. These are the thumbnail sizes, sometimes called intermediate or registered image sizes. They exist so a 4,000-pixel photo is never squeezed into a 300-pixel card: the theme asks for the size it needs, and the browser downloads a file close to the size it will actually display.
The name is a little misleading. "Thumbnail" is one specific size, the small square one, but the term is often used for all the generated copies. In code, a featured image is also called a "post thumbnail", which adds to the confusion.
The default sizes
Settings, then Media shows three sizes you can change:
- Thumbnail: 150 by 150 pixels, cropped to an exact square by default.
- Medium: fits within 300 by 300 pixels, keeping the image's proportions.
- Large: fits within 1024 by 1024 pixels, keeping proportions.
WordPress also creates sizes that are not shown on that screen: a 768-pixel-wide "medium_large" copy and, for big uploads, copies that fit within 1536 and 2048 pixels, used for high-density screens. If an upload is wider or taller than 2560 pixels, WordPress scales it down to that limit and uses the scaled version as the "full size", while keeping the original file. Sizes larger than the original are skipped, since WordPress never upscales.
Themes and plugins add their own sizes on top. A theme might register a wide size for featured images and a square one for related posts, and WooCommerce registers sizes for product images. A single upload can easily produce ten or more files.
How the sizes are used
When WordPress outputs an image in post content, it adds srcset and sizes attributes listing the available copies, and the browser picks the most suitable one for the screen. This is responsive images working automatically, and it is the main reason the extra sizes are worth their disk space. Themes request a size by name, for example with the_post_thumbnail( 'large' ).
Adding and removing sizes
Developers register sizes in the theme's functions.php or a plugin:
// A 600 x 400 card image, cropped to fit exactly.
add_image_size( 'card', 600, 400, true );
// Crop from the top center instead of the middle.
add_image_size( 'banner', 1200, 400, array( 'center', 'top' ) );
The last argument controls cropping. Without it, the image is scaled to fit inside the box and keeps its shape; with it, the image is cut to the exact dimensions. Sizes a site never uses can be removed with remove_image_size(), or skipped with the intermediate_image_sizes_advanced filter.
Regenerating thumbnails
Changing a size, or switching to a theme with different sizes, only affects new uploads. Existing images keep their old copies until they are regenerated, either with the Regenerate Thumbnails plugin or with WP-CLI:
wp media regenerate --yes
On a large media library this takes a while and puts load on the server, so run it during a quiet period, and take a backup first.
Good practice
- Upload sensible originals. Upload at least as large as the biggest size the theme displays, but there is little point uploading camera originals many times wider than any screen.
- Prune unused sizes. Every registered size multiplies storage and backup size, and slows uploads.
- Compress. Use image compression and modern formats such as WebP or AVIF where the server supports them. Many optimization plugins compress every generated size, not just the original.
- Mind the crop. Hard-cropped sizes can cut off heads and text. Choose crop positions that suit the content, or use proportional sizes.
Our guide to optimizing image sizes goes further into formats and compression settings.
FAQs
What is a thumbnail in WordPress?
It is the smallest copy WordPress makes of an uploaded image, 150 by 150 pixels by default, often used in galleries and post lists. The word is also used loosely for all the resized copies, and in code a featured image is called a post thumbnail.
What is the best YouTube thumbnail size?
YouTube recommends 1280 by 720 pixels, a 16:9 ratio, with a minimum width of 640 pixels. That is separate from WordPress's own sizes, which apply to images uploaded to your media library.
Can I use GIFs as thumbnails?
Yes, but WordPress's resized copies of an animated GIF are usually static, showing only the first frame, so the animation only plays at full size. Animated GIFs are also heavy files; a short MP4 or WebM video is usually a lighter way to show motion.
How many image sizes does WordPress generate?
Settings, then Media lists three (thumbnail, medium, and large), but core also creates a 768-pixel medium_large copy and, for large uploads, 1536- and 2048-pixel copies and a scaled full size. Themes and plugins often add more, so check what is registered on your site.
How do I reduce the storage space used by thumbnails?
Find out which sizes your theme and plugins actually use, stop generating the rest, and delete their old files with a cleanup or regeneration tool. Compressing every generated size and serving WebP or AVIF saves more space again.