Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

iTechGuides is reader-supported. When you buy through links on our site, we may earn an affiliate commission. As an Amazon Associate I earn from qualifying purchases. Learn more

Incorrect WordPress thumbnails usually have one of three causes: the required size is defined in a different place than you expect, the crop mode does not match the layout, or an old derivative is still being served. Fix the source definition first, regenerate existing attachments, then verify the URL and responsive markup that the browser actually renders. Changing a Media setting or theme function does not rebuild image files that already exist.

What WordPress calls a thumbnail

When you upload an image, WordPress keeps the original file and creates derivative files at registered sizes. The standard Thumbnail size is 150 × 150 pixels by default. Medium, Large, Medium Large, and any sizes registered by the active theme or a plugin are separate derivatives, not alternate views of the original.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

A page can therefore show an image that looks wrong even when the original upload is perfect. The page may be requesting a stale derivative, a theme-specific size, or a responsive candidate that does not fit the displayed box. WordPress does not automatically recreate old derivatives when you change a setting or edit theme code.

Diagnose the actual source of the wrong size

1. Measure what is displayed

Right-click the image, choose the browser’s inspect or developer-tools command, and record both the rendered dimensions and the file’s intrinsic dimensions. A 150 × 150 file displayed in a 300 × 200 CSS box is a different problem from a 1,200-pixel file being constrained to 300 pixels by CSS.

#1 Best Overall
Sale
Compressed Air Duster,130000RPM Super Power Cordless Air Duster,Rechargeable Brushless Blower,3 Gear Adjustable Blower with LED Light,Dust Remover for Computer/House/Outdoor/Car
  • Powerful Turbo Fan:CAGIWIRU Electric Air Duster have reached speed up to 130000RPM,Can efficient remove dust and debris.With LED light and Three Adjustable Speed to meet with different cleaning tasks.
  • With Attached USB C Fasting Charging cable.Charing 3 hours,Enjoy up to 240 minutes of use on the lowest setting, For third speed can use for 25mins.with four charging options to meet with your needs.
  • Wide Application:Upgraded attached 5 different nozzles,making it suitable for a variety of scenes, such as car,pet, pc, keyboards, and other electronic devices. It also serves for office and home clean duster.
  • Handy Design & Portable:Cordless air duster electric nozzle is Light weight and small size, design and comfortable to hold and space saving, convenient to carry around. You can put it in your room or inside the car without taking up space.
  • Warranty & Support: Our Electric air duster comes with 5 years warranty and 24/7 customer service. During this period, if you have any questions,pls kindly feel free to contact us.

2. Read the image URL

In the img element, inspect the current src and every URL in srcset. Common clues include:

  • -150x150: the default thumbnail derivative.
  • -300x200 or another numeric suffix: a proportional or cropped registered size.
  • A descriptive custom suffix: a theme or plugin size registered with add_image_size().
  • The original filename with no size suffix: the full-size upload, possibly being resized only by CSS.

The URL tells you what WordPress selected, not merely what your media library preview shows. Open the URL directly and check its pixel dimensions to determine whether the error is in file generation or in presentation.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

3. Identify the requested size

Look at the template or block that outputs the image. A featured-image call may request post-thumbnail, while a gallery, widget, or custom block may request thumbnail, medium, or a theme-specific name. The name requested by the template must match a registered size; changing the administrator’s Thumbnail fields will not change a template that explicitly asks for another size.

Check both WordPress settings and theme registrations

Media settings

  1. In the WordPress dashboard, open Settings > Media.
  2. Review the pixel values for Thumbnail size, Medium size, and Large size.
  3. Check whether Crop thumbnail to exact dimensions (normally thumbnails are proportional) is enabled.
  4. Save the settings only after deciding the dimensions your layout actually needs.

The crop checkbox applies to the administrator-defined Thumbnail size. With cropping enabled, WordPress produces the requested width and height as a fixed rectangle, removing excess areas. With it disabled, WordPress scales proportionally so the image fits within the specified bounds; one dimension can be smaller than the value entered.

Theme and plugin code

The active theme can register a different featured-image size or override the apparent thumbnail behavior. Search the active theme and relevant plugins for these functions:

Rank #2
EVEO® Screen Cleaner Spray Kit (Streak-Free) TV Screen Cleaner for Smart TV, Lcd, LEd, Oled | Computer Screen Cleaner Spray and Wipe Microfiber Cloth - TV, Monitor, Laptop, iPad, Car - 6.7oz 1 Pack
  • Screen Cleaner is Your Screen’s New Bestfriend! - EVEO is proud to present a screen cleaner that’s perfectly suited for your TV. Meet your new screen cleaner, computer screen cleaner, laptop cleaner, iPad cleaner, Macbook,tv cleaner or any other electronic device. Our screen cleaner spray and wipe along with the included plush microfiber cloth, easily removes dust, fingerprints & other smudges on the screen’s surface. Clean effectively for a streak-free screen
  • Gentle on your Screens - Our screen cleaner spray and wipes is compatible to be used even for the most sensitive LCD, LED, CRT, and OLED screens in proper use. Be at ease knowing that this product is compatible with all the major brands: LG, SONY, Samsung, Sharp, iPad, iPhone, Android screens, Kindle, PC monitors - we’ve got you covered! Can be used as LCD screen cleaner, tv cleaner, smart tv screen cleaner, and more
  • Premium Super Soft Plush Microfiber Cloth - Included in this efficient screen cleaning kit. This screen cleaner spray and wipe has our signature plush microfiber cloth specially designed to comply with screens and monitors and leave them streak-free. Has been shown to effectively absorbs stubborn stains, zero streaks, and no fiber shedding. Always use this together with our screen cleaner for the best results
  • Easy-to-Use Screen Cleaner Kit + microfiber cleaning cloth - The EVEO Screen Cleaning Kit will easily be your new favorite tool when it comes to taking care of the things you love most, quick and easy solution for a streak-free screen. Simply screw on the sprayer gun on the screen cleaner bottle. Spray the cleaning liquid onto the microfiber cloth, then wipe the screen until desired cleanliness & shine is achieved.
  • Quality Screen Care Kit Worth Purchasing - Enjoy a convenient Screen Cleaner anytime, anywhere you need it. Your satisfaction is our top priority. We stand behind the quality of our products and that’s why, you shouldn’t be worrying at all. We manufacture the Best Screen Cleaner. and can be used for laptop cleaning kit, laptop screen cleaner, tv screen cleaner for smart tv. MacBook screen cleaner, monitor cleaner or screen cleaner spray for electronic devices with microfiber cleaning cloth
set_post_thumbnail_size( 640, 360, true );
add_image_size( 'card-landscape', 640, 360, true );
add_image_size( 'article-inline', 900, 0, false );

The third argument in set_post_thumbnail_size() and add_image_size() controls cropping. true requests a hard crop to the exact box; false preserves the aspect ratio while fitting within the supplied dimensions. A zero height or width is commonly used when the other dimension should govern proportional scaling.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

set_post_thumbnail_size() defines the theme’s post-thumbnail size; it is not necessarily the same as the dashboard’s thumbnail size. A plugin can also register its own name and use that name in a shortcode or block. If you cannot find the registration in the child theme, inspect the parent theme and plugins that control the affected component.

After editing code, clear any PHP opcode cache or page cache used by your host, and confirm that the changed code is loaded on the front end. A typo in a size name can cause a template to fall back to another image size or the original file.

Choose proportional scaling or a hard crop deliberately

Use proportional scaling when the entire image matters

Proportional scaling keeps the complete photograph or illustration visible. It is appropriate for article images, product details, diagrams, and portraits where cutting off the subject would be misleading. The resulting files may have different heights, so the surrounding layout must allow that variation.

Use a hard crop for uniform cards and grids

A hard crop gives every card the same rectangle, which keeps rows aligned. It can remove faces, logos, or other focal content if the crop position is not suitable. Test representative landscape, portrait, and square uploads; one crop setting rarely works perfectly for every composition.

Free tools Windows power users keep installed

One-click scans. No signup required.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
Rank #3
BladeHawks RGB Gaming Mouse Pad Extra Large Extended 31.5x12 Inch-Black
  • 【Large size】:Measuring 800 x 300 mm/ 31. 5×12 inches, which is wider and taller than others. Large mouse pad can perfectly fit your keyboard and mouse of any size, and there is also ample space for peripherals such as phones, tablets, etc.
  • 【LED backlight mouse pad】:Blade Hawks RGB mouse pad provides 7 static modes and 7 dynamic modes will give you the options you are looking for. Power-off memory function remembers the last lighting mode you selected. The super glow fiber Chroma will give you a colorful gaming setup that you want.
  • 【Anti-slip rubber base】:Made from Natural rubber, this gaming mousepad will firmly grip your desktop, allowing you to enjoy the ultimate precision in the games you are most passionate about. It also comes with a texture that enhances this ability even further.
  • 【Smooth and waterproof surface】: Micro-textured cloth surface, for extremely precise mouse control and a smooth movement. When liquid splashes on the gaming mouse pad, it forms water droplets and slides down. Will not delay your work or gameplay.
  • 【Plug and play】: This mouse and keyboard pad is powered by USB, plug and play, no driver required. One button control light modes. Press one time to change the lighting mode, press twice to change the brightness, press and hold about 3 seconds turn ON/OFF.

If the subject is repeatedly cut off, changing only the pixel dimensions will not solve the problem. Adjust the registered crop dimensions, use a focal-point feature supplied by your image workflow, or select a different source image. Do not stretch an image to force it into a box: stretching changes the aspect ratio and produces visible distortion.

Regenerate existing attachments after correcting the definition

Changing the size definition affects future uploads immediately, but existing attachments still have the old derivative files. Regeneration creates the new derivatives from each attachment’s original full-size file. It does not improve a low-resolution original and does not replace that original.

Before regenerating

  • Make a current backup of the uploads directory and database, especially on a production site.
  • Confirm the active theme and the plugins that register image sizes. Deactivate or remove obsolete registrations first if they are generating unwanted files.
  • Check available disk space. A large library and several new sizes can temporarily require substantial additional storage.
  • Decide whether to preserve old, no-longer-used derivatives until caches and external references have expired.

Regenerate through the dashboard

A reputable thumbnail-regeneration plugin can process the Media Library after you save the new settings or code. Install one that is maintained and compatible with your WordPress version, then use its regeneration command, usually from a Tools or Media screen. Select all attachments for a library-wide repair, or select only the affected date range when the change concerns a recent import. Let the process finish; interrupting a browser-based batch can leave the library partially rebuilt.

Regeneration tools may offer a choice between all registered sizes and a selected size. Rebuilding only the changed size is faster and reduces disk use, but rebuilding all sizes is appropriate when several registrations or crop rules changed together.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Regenerate with WP-CLI

On a site with shell access and WP-CLI, run the command from the WordPress installation directory:

Rank #4
Sale
Vaydeer Wrist Rest for Keyboard and Mouse, Computer Ergonomic Wrist Support Pad, Soft Memory Foam Arm Cushion for Desk, Palm Hand Office Laptop Typing
  • 【Softer and More Comfortable】Vaydeer wrist rest has unique diamond pattern, which is the combination of softness and aesthetics. The materials of wrist rest are improved into higher quality memory foam and covered with silky smooth lycra. The computer wrist rest makes you as comfortable and cushiony as like rest your wrists on clouds.
  • 【Ergonomic Wrist Saver】The wrist rests for keyboard and mouse comes with a 17.32×3.15×0.83 inch keyboard wrist pad and a 5.94×3.15×0.83 inch mouse wrist support. Based on ergonomic design, the unique concave shape is the perfect fit for your wrist joints. The wrist rest pad fits most computer keyboards and laptops, improve hand and wrist posture, release your wrist and arm stress.
  • 【Non-Slip Rubber Bottom】Featuring an anti-skid silicone base on the bottom, this wrist keyboard support stays firmly in place on your desk, preventing the padding from sliding around, ensuring stable and consistent wrist support during extended computer sessions.
  • 【Better Experience & Pain Relief】Our keyboard arm rest is beneficial to alleviate the soreness caused by direct contact and friction between your arm and a hard desk surface, reducing the risk of wrist fatigue or carpal tunnel. The soft texture of memory foam can evenly distribute the pressure around your wrists and provide good support with just enough give.
  • 【Helpful in Multiple Scenarios】Whether you're working, studying, writing, typing, gaming, this keyboard and mouse rest combo is an essential accessory to add comfort and support to your hands and wrists. It’s also a great gift for men, women, family, friend, coworker, gamer, teacher, etc.
wp media regenerate

WP-CLI asks for confirmation and processes existing attachments. To target one registered size, use the image-size filter:

wp media regenerate --image_size=thumbnail

Replace thumbnail with the exact registered name, such as post-thumbnail or a custom name. You can restrict the operation to selected attachment IDs by supplying those IDs after the command:

wp media regenerate 184 219 305 --image_size=card-landscape

Run wp media image-size to inspect registered sizes when you are unsure of a name. On a very large library, process IDs in batches and monitor disk space, execution time, and web-server load.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

When the file is correct but the page still looks wrong

WordPress has native responsive-image support: since WordPress 4.4, generated image markup can include srcset and sizes attributes. The browser uses those hints, the viewport, and the device pixel ratio to choose a candidate. The URL visible in the initial HTML may not be the URL ultimately downloaded.

Inspect responsive selection

  1. In developer tools, open the final img element and expand srcset and sizes.
  2. In the Network panel, reload the page and identify the image request that actually completed.
  3. Compare that file’s dimensions with the CSS-rendered width. If the browser chooses a 150-pixel candidate for a 600-pixel slot, the sizes hint or the requested WordPress size is too small.
  4. Check whether a lazy-loading, optimization, CDN, or caching layer rewrites the URL. Purge that layer after regeneration.

A correct srcset still cannot fix an incorrect sizes value. For example, a layout that occupies 50vw on desktop should not advertise itself as 100vw, because the browser may download a larger file than necessary; advertising a tiny slot can produce blur. Use a sizes expression that reflects the actual layout at each breakpoint.

Best Value
Sale
Under Desk Cable Management Tray No Drill, Metal Mesh Cable Management Under Desk with Clamp Mount, 2 Hole Cable Tray with Wire Management and Cord Organizer for Home Office Standing Desk
  • 【No Drill Mounted】Cable management tray can be assembled in as little as 3 minutes or less-simply. Side clips easily clampe the edge of desk, pass through the holes on the sides, and secure excess cables with baskets. Desk cable management supports inward or outward installation to meet your needs in different scenarios, and provides you with great convenience when collecting and organizing wires.
  • 【Rubber Pad Protects Desk】Wire organizer under desk built-in soft rubber pads on the clamp protect your desk from scratches, so you will not damage your furniture or office.
  • 【Sturdy and Beautiful】Cord management under desk is made of high-quality carbon steel and holds about 15 lbs. The wire basket has 2 holes on each side of the tray to enable your cables to pass freely. Cable baskets are suitable for desk thickness use from 0.4" to 2.4".
  • 【Space Saving & Keep Organized】Desk cable management tray holds all your power cords, outlet strips, USB hubs and computer transformers hidden from your feet, and the data cables will not enter the vacuum cleaner to keep your desk clean and tidy. Desk wire organizer is also suitable for use in the kitchen and outdoors.
  • 【Reduce Safety Risks】Cable tray under desk keeps all plugs away from your kids, no more worry about tripping. Using 2 holes wire tray saves extra space, helps you easily cabling and wire protection. The mesh design is not easy to accumulate dust, but avoids safety accidents caused by messy wires.

Check CSS and theme markup

CSS controls presentation, not the pixels stored in the derivative. Inspect width, height, max-width, aspect-ratio, and object-fit. A fixed height combined with object-fit: cover creates a visual crop even when the source file is proportional. A fixed width and height without an appropriate fit rule can stretch the image. Remove conflicting declarations from page-builder or block styles, and verify that the theme is not applying a background image or a separate mobile source.

If the HTML requests a named size that no longer exists, the theme may fall back to a larger file and rely on CSS. That can look acceptable at one breakpoint while appearing soft or oddly cropped at another. Correct the template’s size name, regenerate that registered size, and then purge caches.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
Independent reader supportYour contribution helps us test, update, and keep practical guides available for everyone.Support on Ko-Fi

Match the fix to the scope of the problem

Situation Source of the size Geometry to choose Scope Best execution method
All default thumbnails are wrong Settings > Media Proportional or exact crop, based on the design Whole library Save settings, then regenerate the Thumbnail size
Only featured images are wrong Theme’s set_post_thumbnail_size() or template request Usually a fixed card crop or a proportional feature image All posts using that theme size Correct code, deploy it, then regenerate the named size
One block, widget, or gallery is wrong Plugin or block’s add_image_size() Follow that component’s box and focal-point needs Attachments used by the component Correct registration and regenerate selectively
The file is right but display is wrong Responsive markup, CSS, cache, or CDN Do not change the crop until markup is verified One template or breakpoint Inspect srcset, sizes, CSS, and cached URLs
A single uploaded image is an outlier Its aspect ratio or source resolution Use proportional scaling or recrop that image One attachment Replace or edit the source; regenerate its derivatives

Common symptoms and targeted fixes

Featured images are cropped to the wrong subject

Confirm that the template requests post-thumbnail and identify the dimensions and crop flag used to register it. If the theme’s crop is intentional but the focal point is not, change the crop dimensions or use a source image with safer margins. Regenerate the affected attachments after the code change.

Thumbnails have inconsistent dimensions

Look for proportional scaling. A non-square source will not become a uniform rectangle when crop is disabled. If the design requires equal cards, register a hard-cropped size and ensure every card uses that name rather than the generic proportional Thumbnail size.

Images are blurry after regeneration

Open the regenerated file itself. If it is sharp at its intrinsic dimensions, inspect the browser’s selected srcset candidate, the sizes attribute, and any optimization or CDN rewrite. If the regenerated file is already soft, the original upload may not contain enough pixels for the requested display size.

New uploads look right but old posts do not

This is the expected result when definitions changed without regeneration. Rebuild the old attachments, purge page and image caches, and check an old post in a private browser window. Do not re-upload every image unless the originals are missing or damaged.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Regeneration reports success but nothing changes

Verify that you edited the active theme, not an inactive theme; that the registered size name is exact; and that the page is not serving a cached or CDN URL. Check the file modification time and dimensions in the uploads directory, then inspect the final network request again.

Verify the repair with old and new images

  1. Choose one attachment uploaded before the change and one uploaded afterward.
  2. Check their generated files in the Media Library or uploads directory for the intended pixel dimensions and crop.
  3. Open a post or archive that uses the affected component and confirm the final downloaded URL.
  4. Test a narrow mobile viewport, a normal desktop viewport, and a high-density display. Confirm that the selected candidate is large enough without being unnecessarily huge.
  5. Check landscape, portrait, and square source images so a crop that works for one composition does not hide important content in another.
  6. After verification, purge page, object, optimization, and CDN caches in the order specified by your hosting setup.

Prevent future thumbnail mismatches

  • Document every custom image-size name, width, height, and crop rule in the theme or plugin repository.
  • Keep image-size registration in the active theme or a site-specific plugin rather than scattering it across temporary snippets.
  • Use descriptive names such as card-landscape and request those names explicitly in templates.
  • Define responsive sizes values from the real layout widths, then check them after major breakpoint changes.
  • Run a targeted regeneration whenever a size definition or crop rule changes; schedule a full-library rebuild only when several sizes changed.
  • Retain the original uploads and maintain backups before bulk operations.
  • Review a representative set of existing posts after every theme replacement, because a new theme can register different sizes while old derivatives remain on disk.

A concise decision sequence

Start with the URL and rendered dimensions, not with another upload. If the wrong derivative is named, inspect Settings > Media and theme/plugin registrations. Decide whether the layout needs proportional scaling or a hard crop. Save the corrected definition, regenerate the relevant attachments, and then inspect srcset, sizes, CSS, and caches if the downloaded file is still not the one you expect. This sequence separates file-generation errors from browser-presentation errors and prevents unnecessary re-uploads.

Product prices and availability are accurate as of the date/time indicated and are subject to change. Any price and availability information displayed on Amazon at the time of purchase will apply.