Categories

← View All Tools

Image Cropper

Crop images to specific dimensions or aspect ratios with custom positioning

Click to upload file or drag and drop file here

Maximum file size: 10MB Supported formats: image/jpeg, image/png, image/webp, image/gif, image/bmp, image/tiff

Upload any image file (JPEG, PNG, WebP, GIF, BMP, TIFF) for cropping

Choose how to crop your image: square, aspect ratio, exact dimensions, or custom positioning

Select a predefined aspect ratio for cropping. The image will be cropped to match this ratio

Set the exact width for cropped area. Will be limited to image width if larger

Set the exact height for cropped area. Will be limited to image height if larger

Choose where to position the crop area. Works with all crop modes

Set the horizontal position for crop area (0 = left edge). Will be adjusted if outside image bounds

Set the vertical position for crop area (0 = top edge). Will be adjusted if outside image bounds

Choose output format or keep original. Converting to JPEG may reduce quality for transparency

Output quality for lossy formats (JPEG, WebP). Higher = better quality but larger file size

Key Facts

Category
Design
Input Types
file, select, number
Output Type
file
Sample Coverage
4
API Ready
Yes

Overview

The Image Cropper is a precise utility designed to trim images to specific dimensions, standard aspect ratios, or custom coordinates, ensuring your visuals fit perfectly into any layout or design requirement.

When to Use

  • •Adjusting image dimensions to meet specific social media or website banner requirements.
  • •Removing unwanted edges or background elements to focus on the subject of a photo.
  • •Standardizing a collection of images to a uniform aspect ratio for consistent gallery displays.

How It Works

  • •Upload your image file in any supported format like JPEG, PNG, or WebP.
  • •Select your preferred crop mode, such as square, predefined aspect ratio, or exact pixel dimensions.
  • •Adjust the positioning using the gravity settings or manual X and Y coordinates.
  • •Choose your desired output format and quality level, then process the file to download your cropped result.

Use Cases

Preparing profile pictures by cropping portraits into perfect 1:1 squares.
Creating consistent 16:9 thumbnails for video content platforms.
Extracting specific sections of high-resolution images for detailed product shots.

Examples

1. Social Media Profile Picture

Content Creator
Background
A high-resolution portrait photo needs to be converted into a standard square profile picture.
Problem
The original photo is rectangular and includes too much background space.
How to Use
Upload the portrait, select 'Square (1:1)' crop mode, and set gravity to 'Center' to keep the face in focus.
Example Config
cropMode: square, gravity: center
Outcome
A perfectly centered 1:1 square image ready for upload to social media platforms.

2. Website Hero Banner

Web Designer
Background
A wide landscape photograph needs to fit a specific website header slot.
Problem
The image is too tall and does not match the required 21:9 cinematic aspect ratio.
How to Use
Upload the landscape photo, select 'Aspect Ratio' mode, choose '21:9', and adjust the Y position to capture the best part of the scenery.
Example Config
cropMode: aspect, aspectRatio: 21:9, gravity: top
Outcome
A professionally cropped widescreen banner that fits the website layout perfectly.

Try with Samples

image, png, jpg
Web Image Processing Python Samples
Web Python image processing examples using PIL/Pillow including reading, saving, resizing, and format conversion
title token image
image
Windows Image Processing C++ Samples
Windows C++ image processing examples including reading/saving images, resizing, and format conversion using Windows Imaging Component (WIC)
title token image
image
Web Image Processing Rust Samples
Web Rust image processing examples including image read/save, scaling, and format conversion
title token image
image
Web Image Processing Go Samples
Web Go image processing examples including image reading/saving, image resizing, and format conversion
title token image
image

Related Hubs

Image Convert Tools
Explore 100 image tools for convert workflows and compare closely related utilities quickly.
Video Convert Tools
Explore 36 video tools for convert workflows and compare closely related utilities quickly.
Image Tools
Explore 40 image tools for utility workflows and compare closely related utilities quickly.
Video Tools
Explore 16 video tools for utility workflows and compare closely related utilities quickly.

FAQ

Which image formats are supported?

You can upload JPEG, PNG, WebP, GIF, BMP, and TIFF files.

Can I crop an image to exact pixel dimensions?

Yes, select the 'Exact Dimensions' crop mode and enter your desired width and height in pixels.

What does the 'Gravity' setting do?

Gravity allows you to anchor the crop area to a specific part of the image, such as the center, top-left, or bottom-right.

Will cropping reduce the quality of my image?

If you choose a lossy format like JPEG or WebP, you can adjust the quality slider to balance file size and visual clarity.

Is there a limit to the file size I can upload?

Yes, the maximum file size for uploads is 10 MB.

API Documentation

Request Endpoint

POST /en/api/tools/image-cropper

Request Parameters

Parameter Name Type Required Description
imageFile file (Upload required) Yes Upload any image file (JPEG, PNG, WebP, GIF, BMP, TIFF) for cropping
cropMode select Yes Choose how to crop your image: square, aspect ratio, exact dimensions, or custom positioning
aspectRatio select No Select a predefined aspect ratio for cropping. The image will be cropped to match this ratio
width number No Set the exact width for cropped area. Will be limited to image width if larger
height number No Set the exact height for cropped area. Will be limited to image height if larger
gravity select No Choose where to position the crop area. Works with all crop modes
x number No Set the horizontal position for crop area (0 = left edge). Will be adjusted if outside image bounds
y number No Set the vertical position for crop area (0 = top edge). Will be adjusted if outside image bounds
format select No Choose output format or keep original. Converting to JPEG may reduce quality for transparency
quality number No Output quality for lossy formats (JPEG, WebP). Higher = better quality but larger file size

File type parameters need to be uploaded first via POST /upload/image-cropper to get filePath, then pass filePath to the corresponding file field.

Response Format

{
  "filePath": "/public/processing/randomid.ext",
  "fileName": "output.ext",
  "contentType": "application/octet-stream",
  "size": 1024,
  "metadata": {
    "key": "value"
  },
  "error": "Error message (optional)",
  "message": "Notification message (optional)"
}
File: File

AI MCP Documentation

Add this tool to your MCP server configuration: 

{
  "mcpServers": {
    "elysiatools-image-cropper": {
      "name": "image-cropper",
      "description": "Crop images to specific dimensions or aspect ratios with custom positioning",
      "baseUrl": "https://elysiatools.com/mcp/sse?toolId=image-cropper",
      "command": "",
      "args": [],
      "env": {},
      "isActive": true,
      "type": "sse"
    }
  }
}

You can chain multiple tools, e.g.: `https://elysiatools.com/mcp/sse?toolId=png-to-webp,jpg-to-webp,gif-to-webp`, max 20 tools.

Supports URL file links or Base64 encoding for file parameters.

If you encounter any issues, please contact us at [email protected]