Plugins Plugin hub Backup SEO Caching Security Forms WooCommerce Images Best backup plugins
Hosting Hosting directory Shared hosting Managed WordPress Cloud hosting VPS hosting By reader location Hosting finder
Themes & builders Compare Rank Math vs Yoast
Tools All tools Hosting finder Plugin stack builder Cost calculator Salt generator Theme detector Who is hosting this? Speed test Headline analyzer robots.txt generator Redirect generator Uptime calculator Blog name generator
Blog Best backup plugins Deals
Guides All guides Speed up WordPress Choose hosting Back up WordPress
How we test

Blogging & content · Guide

How to Crop an Image in WordPress (Step by Step)

How to Crop an Image in WordPress (Step by Step)

Short answer

Select the Image block and click Crop in its toolbar. Drag the frame, zoom or pick an aspect ratio, then click Apply. To change the stored image or its thumbnail, open it in Media, then Library, click Edit Image and use the crop tool there.

Key takeaways

  • The Image block toolbar has a built-in Crop button.
  • Block crops save a new copy and keep the original.
  • The Media Library editor can crop only the thumbnail size.
  • The aspect ratio setting is a visual crop that leaves the file unchanged.
  • Restore original image undoes Media Library edits.

How do you crop an image in WordPress?

Select the Image block, click the Crop button in its toolbar, drag the frame or pick an aspect ratio, then click Apply; or open the image in Media > Library, click Edit Image and use the crop tool there.

Both methods are built into WordPress, so you do not need a plugin or a separate photo editor for basic crops.

The block editor method is quickest for one post. The Media Library method changes the stored image, which is better for featured images and images you reuse.

The WordPress documentation on the Image block and on editing media covers both tools.

Which cropping method should you use?

Use the Image block crop for a single image in a post, the Media Library editor when you want to change the image everywhere or the thumbnail, and the aspect ratio setting when you only need a visual crop.

Here is a quick comparison:

MethodWhereCreates a new file?Best for
Image block CropBlock toolbarYes, a cropped copyOne image in one post
Media Library Edit ImageMedia > LibraryEdits stored sizesFeatured images, reused images
Aspect ratio settingBlock sidebarNo, CSS onlyMatching sizes in a layout
External editorYour computerYes, before uploadPrecise or heavy edits

The difference matters. A real crop changes the image file, while an aspect ratio setting only hides part of the image on screen.

Step 1: How do you crop an image in the Image block?

Click the image in the editor, then click the Crop icon in the block toolbar to open the crop frame directly on the canvas.

If you do not see the Crop button, make sure the whole Image block is selected and not its caption.

Images from external URLs cannot always be cropped in the editor. Upload the image to your Media Library first.

The cropping tools arrived in the block editor in WordPress 5.5. The core team's post on editing images in the block editor introduced them.

Step 2: How do you adjust the crop area?

Drag the image inside the frame to reposition it, use the zoom control to enlarge it, choose an aspect ratio from the dropdown, and rotate it if needed.

The aspect ratio menu offers common shapes like square, 16:9 and 4:3, plus the original ratio. Pick one when you want images to line up neatly.

The zoom slider crops tighter around the center of interest. Drag the photo afterwards to choose which part stays visible.

Rotate turns the image by 90 degrees each click. That helps with sideways phone photos.

Step 3: How do you apply and save the crop?

Click Apply in the toolbar to confirm the crop, then update or publish the post; WordPress saves the cropped version as a new image in your Media Library.

The original upload stays in the library. You can go back to it at any time by replacing the image in the block.

Click Cancel instead of Apply if the crop is not right. Nothing changes until you apply.

Step 4: How do you crop an image in the Media Library?

Go to Media > Library, click the image, choose Edit Image, then click the Crop button, drag a selection on the image, click Crop again and save.

The image editor screen has several tools on the right:

  • Scale image: resize the original to new pixel dimensions.
  • Crop: drag a selection, or set an aspect ratio and exact selection size.
  • Rotate and flip: turn or mirror the image.
  • Image crop: type a ratio such as 1:1 to lock the shape.
  • Thumbnail settings: choose which sizes the change applies to.

The Apply changes to option lets you edit all sizes, only the thumbnail, or all sizes except the thumbnail. Choosing only the thumbnail is a neat way to fix awkward square crops on archive pages.

If you make a mistake, the Restore original image link appears after you save. It brings back the uploaded version.

How does the aspect ratio setting differ from cropping?

The aspect ratio option in the Image block sidebar shows the image at a set shape using CSS, without changing the file, and lets you choose whether the image fills or fits the frame.

This is useful in grids and galleries, where you want every image to share the same shape.

Under the hood it works like the CSS object-fit property on MDN. Cover fills the frame and hides the edges, while contain shows the whole image with empty space.

Theme developers can register custom ratios. The WordPress developer blog explains registering custom aspect ratios for themes.

Crop featured images in the Media Library editor, or in the image modal when you set the featured image, because the featured image panel itself has no crop button.

Your theme decides the display size of featured images. Some themes crop them automatically to a fixed ratio, which can cut off heads or text.

To control which part shows, crop the image yourself to match the theme's ratio before setting it. Our guide on how to set a featured image in a WordPress post covers the panel.

When should you crop images before uploading?

Crop before uploading when you need precise edits, consistent sizes across many images, or large files reduced, because a desktop or online editor gives finer control than WordPress.

The built-in tools are fine for quick fixes. They are less handy for batches of product photos or images that need retouching.

Free editors on most computers can crop to exact pixel sizes. Cropping first also means you upload smaller files, which saves storage and speeds up the Media Library.

A simple routine works well for most sites:

  1. Decide the final shape, such as 16:9 for blog headers.
  2. Crop and resize the photo on your computer.
  3. Export it as a compressed JPEG or WebP.
  4. Upload it and add alt text.

If you sell products, keep all product photos at the same ratio. WooCommerce galleries and shop grids look tidier when every image shares one shape.

Why is WordPress cropping my images automatically?

WordPress creates several image sizes on upload, and your theme or WooCommerce may set some of them to hard crop, which trims images to an exact width and height.

You can see the default sizes in Settings > Media. The thumbnail size has an option to crop to exact dimensions.

Themes and plugins add their own sizes with the add_image_size function, which includes a crop setting.

Changing these sizes only affects new uploads. To apply them to existing images, use a thumbnail regeneration plugin.

Our guide on how to properly size images in WordPress explains the sizes in detail.

Why is the crop option missing or not working?

The crop option is usually missing because the image comes from an external URL, the server lacks an image library like GD or Imagick, the file type is not supported, or a plugin conflicts with the editor.

Try these checks:

  • Upload the image to the Media Library instead of linking to it.
  • Check Tools > Site Health for a missing image editing module.
  • Try a common format like JPEG or PNG.
  • Disable image optimization or media plugins briefly and test again.
  • Clear your browser cache and reload the editor.

If uploads themselves fail, see our fix for the HTTP error when uploading images.

How do you keep cropped images fast and sharp?

Upload images close to the size you need, crop before compressing, and use modern formats, so cropped images stay sharp without adding extra weight to the page.

Each crop in the block editor creates a new file, so cropping many images in many posts adds files to your library. Clean up unused images now and then.

For compression and format tips, read our guide on how to optimize images for WordPress.

If you build galleries from cropped images, our guide on how to add an image gallery in WordPress shows the layout options.

Frequently asked questions

Does cropping an image in WordPress change the original file?

Cropping in the Image block saves a new cropped copy and leaves the original in the Media Library. Cropping in the Media Library editor changes the stored image sizes, but WordPress keeps the original so you can use Restore original image later.

How do I crop an image to a square in WordPress?

Select the Image block, click Crop, open the aspect ratio menu and choose square, then click Apply. In the Media Library editor, type 1 and 1 in the aspect ratio fields before dragging your selection.

Can I undo a crop in WordPress?

Yes. In the block editor, press undo or replace the image with the original from the library. In the Media Library editor, click Restore original image after saving, which brings back the uploaded version.

Why can't I crop an image in WordPress?

The image may be linked from another site, your server may be missing an image editing library, or a plugin may be interfering. Upload the image to your library, check Site Health and test with media plugins turned off.

Do I need a plugin to crop images in WordPress?

No. WordPress includes crop, rotate, flip and scale tools in both the Image block and the Media Library editor. Plugins are only useful for advanced needs such as cropping each image size separately or bulk regeneration.

Sources

  1. Image block WordPress.org Documentation
  2. Edit Media WordPress.org Documentation
  3. Editing Images in the Block Editor Make WordPress Core
  4. Registering custom aspect ratios in WordPress 6.6 WordPress Developer Blog
  5. add_image_size() WordPress Developer Resources
  6. object-fit 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.

About the editors

Written and checked byWPLegible Editorial Team Independent WordPress reviews and guides

Researched from the primary sources listed above and checked against our editorial rules before publishing.