Blogging & content · Explainer
What Is WordPress Featured Image Size? Explained

Short answer
WordPress has no single required featured image size. Your theme sets the dimensions it displays, so sizes vary between themes. A safe choice for most blogs is 1200 x 628 pixels, which fits common layouts and social media previews without looking blurry or slowing the page.
Key takeaways
- The theme decides featured image dimensions, not WordPress core.
- 1200 x 628 px is a safe default for blogs and social previews.
- Default sizes are thumbnail 150, medium 300, medium large 768 and large 1024 pixels.
- New sizes only apply to future uploads unless you regenerate thumbnails.
- Inspect a featured image in your browser to see the size your theme uses.
Is there a standard WordPress featured image size?
No, WordPress has no single required featured image size; your theme decides how large featured images display, and 1200 x 628 pixels is a safe general choice for most blogs.
A featured image, also called a post thumbnail, is the main image attached to a post. Themes show it at the top of the post, in blog listings and in related post grids.
Each theme can register its own featured image dimensions. One theme may crop to a wide banner, while another shows a square card. That is why advice online varies so much.
The 1200 x 628 recommendation exists because it fits most theme layouts and also works well for link previews on social networks. It is a starting point, not a WordPress rule.
The WordPress documentation explains where the featured image panel sits in the editor if you are new to setting one.
How does WordPress decide the featured image size?
WordPress uses the size the theme registers with set_post_thumbnail_size or add_image_size, and if the theme sets nothing, it falls back to one of the default sizes or the original image.
Themes register sizes in their functions.php file. The set_post_thumbnail_size function creates a size named post-thumbnail with a width, height and crop setting.
Many themes add more sizes with add_image_size, for example one for the single post header and another for archive cards.
When you upload an image, WordPress creates a copy at each registered size. The theme then asks for the copy it needs, and the browser picks the best fit from the srcset list.
Block themes work a little differently. The Post Featured Image block has its own aspect ratio, width and height controls in the Site Editor, so the template can crop images with CSS rather than a fixed PHP size.
What are WordPress's default image sizes?
WordPress creates thumbnail, medium, medium large and large copies of every upload, plus two extra-large sizes for high-resolution screens.
| Size name | Default maximum | Crop | Where to change |
|---|---|---|---|
| Thumbnail | 150 x 150 px | Hard crop | Settings > Media |
| Medium | 300 x 300 px | No crop | Settings > Media |
| Medium Large | 768 px wide | No crop | Code only |
| Large | 1024 x 1024 px | No crop | Settings > Media |
| 1536 x 1536 | 1536 px | No crop | Code only |
| 2048 x 2048 | 2048 px | No crop | Code only |
The three sizes in Settings > Media are the ones most people change. Our guide to WordPress image size settings explains each field.
WordPress also scales down very large uploads. Since version 5.3, images wider or taller than 2560 pixels get a scaled copy, and that copy becomes the one used on the site. The original is kept on the server.
Theme sizes come on top of these. A theme with three custom sizes means each upload creates nine or more files.
What size should you upload for a featured image?
Upload an image at least as wide as the largest size your theme displays, usually 1200 to 1600 pixels wide, in the aspect ratio your theme crops to.
Uploading too small makes images blurry, because WordPress cannot add detail that is not there. Uploading a huge camera photo wastes disk space and slows uploads, even though WordPress makes smaller copies.
Here are common choices by use:
- General blog posts: 1200 x 628 px (roughly 1.91:1), which suits most themes and social previews.
- Full-width hero headers: 1600 to 1920 px wide, cropped to the theme's banner shape.
- Square grid layouts: 1200 x 1200 px.
- WooCommerce products: product images use their own sizes, covered in our guide on changing WooCommerce product image size.
Keep the main subject in the centre of the image. Themes often crop the edges in archive views, and centred subjects survive those crops.
How do you find your theme's featured image size?
Check the theme's documentation first, then look for set_post_thumbnail_size or add_image_size in its functions.php, or inspect a featured image on the front end to see its displayed size.
The quickest method is the browser. Right-click a featured image on a single post, choose Inspect, and look at the width and height of the image file in the src or srcset attribute.
Do the same on the blog page and the home page. The archive size is often smaller and cropped differently from the single post header.
If you can read code, search the theme folder for add_image_size. Each call shows a size name, width, height and crop value. Our guide on how to see code in WordPress explains where to find theme files.
What happens if your featured image is the wrong size?
A wrong-sized featured image gets cropped awkwardly, scaled up and blurry, or shown with empty space, depending on the theme's crop setting.
Hard-cropped sizes cut the image to exact dimensions. If your upload has a different shape, WordPress trims the edges, which can cut off heads or text.
Soft-cropped sizes keep the full image and scale it to fit. A tall image in a wide slot may then leave gaps or look tiny.
Images smaller than the registered size are never scaled up by WordPress. The theme stretches them with CSS, and they look soft on large screens.
How do you change the featured image size?
Change it in the theme's customizer or settings if available, adjust the Post Featured Image block in a block theme, or override the size with set_post_thumbnail_size in a child theme.
Many popular themes expose featured image options in Appearance > Customize, such as aspect ratio or whether to show the image at all.
In block themes, open the Site Editor, edit the Single Posts template, and select the Post Featured Image block. Its sidebar has aspect ratio, height and scale options.
For classic themes without options, add your own size in a child theme and use it in the template. Our explainer on what a child theme is covers why changes belong there rather than in the parent theme.
To change which image is used rather than its size, see our guide on how to set a featured image in a WordPress post.
Do old images update when you change sizes?
No, new sizes only apply to images uploaded after the change; existing images need their thumbnails regenerated with a plugin or a WP-CLI command.
WordPress generates resized copies once, at upload time. If you switch themes or change sizes, your old images lack the new copies, and the theme falls back to the nearest size it can find.
The wp media regenerate command rebuilds all sizes from the originals. Plugins such as Regenerate Thumbnails do the same from the dashboard.
If regeneration fails or images still look wrong, our guide on fixing thumbnails not generating covers server and permission problems.
How do featured image size and page speed relate?
Large featured images are often the biggest element on a post page, so their file size directly affects load time and the Largest Contentful Paint score.
WordPress helps by adding srcset and sizes attributes, so phones download smaller copies. That only works well if your theme registers sensible sizes.
Compress images before uploading, and consider modern formats such as WebP. web.dev explains how responsive images cut wasted bytes on small screens.
Avoid lazy loading the featured image when it appears at the top of the post. WordPress skips lazy loading for the first large image by default for this reason.
Our guide on serving images in next-gen formats shows how to switch to WebP or AVIF.
What about featured images on social media?
Social networks read the image set in your Open Graph tags, which SEO plugins usually fill from the featured image, so a 1200 x 628 image previews well on most platforms.
When someone shares your link, platforms show a preview card with a title and image. They crop to a wide shape close to 1.91:1, which is why the 1200 x 628 size became popular.
SEO plugins let you set a separate social image per post if your featured image is a different shape. Use that option when your theme needs square or tall featured images.
Frequently asked questions
What is the best featured image size for WordPress?
For most blogs, 1200 x 628 pixels works well because it suits typical theme layouts and social media link previews. If your theme uses square cards or full-width banners, match its aspect ratio and upload at least as wide as the largest display size.
What is the default thumbnail size in WordPress?
The default thumbnail size is 150 x 150 pixels with a hard crop. You can change it under Settings, then Media. The featured image size is separate and is usually set by your theme rather than by the thumbnail setting.
Why is my featured image cropped?
Your theme probably registers a hard-cropped featured image size. When the upload has a different shape, WordPress trims the edges to fit. Upload images in the theme's aspect ratio and keep the main subject near the centre.
Why is my featured image blurry?
The uploaded file is likely smaller than the size the theme displays, so the browser stretches it. Upload a larger image, at least as wide as the display size, and regenerate thumbnails if you changed themes recently.
Does featured image size affect SEO?
Indirectly. Very large files slow down pages and can hurt Core Web Vitals scores. A well-sized, compressed image with descriptive alt text supports both page speed and image search visibility.
Sources
- set_post_thumbnail_size() WordPress Developer Resources
- add_image_size() WordPress Developer Resources
- wp media regenerate WordPress Developer Resources
- Serve responsive images web.dev
- Using responsive images in HTML 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.


