> For the complete documentation index, see [llms.txt](https://minimateapps.gitbook.io/mini-image-upload-and-file-upload/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://minimateapps.gitbook.io/mini-image-upload-and-file-upload/how-to.../how-to-set-image-dimensions-and-cropping.md).
# How to set image dimensions and cropping
Control the size of uploaded images and let customers crop them before adding to cart.
There are two separate rules that work together to control image quality and shape: **Image dimensions** (sets size restrictions) and **Image editor** (lets customers crop). You can use either one on its own or both together.
* Please go to the "Upload Rules" tab while creating a field
* Click "Add a rule" button
### **1. Image dimensions**
This rule restricts the pixel size of the images customers can upload.
* Under **File requirements**, select "Image dimensions"
* Enter the size limits you want to enforce:
* **Minimum width** and **Maximum width** (in pixels)
* **Minimum height** and **Maximum height** (in pixels)
* Customize the **error message** that appears when an uploaded image doesn't meet the requirements. The default is "Please check the number of files uploaded."
**When to use**
* If you need print-quality images (e.g. set a high minimum width and height)
* If you want to block oversized images that slow down processing
* If your product requires a specific size range (e.g. for engraving or printing)
{% hint style="info" %}
You don't need to fill in all four fields. Leave a field empty if you don't want to enforce that limit — for example, set only the **minimum width** and **minimum height** if you only care about image quality, not maximum size.
{% endhint %}
### **2. Image editor (Cropping)**
This rule lets customers crop their image directly in the upload field before submitting.
* Under **Customer experience**, select "Image editor"
* Choose the cropping behavior:
* **Allow free-form cropping** — customers can crop to any shape or size
* **Allow square-only cropping** — customers can only crop to a square
* **Allow circle-only cropping** — customers can only crop to a circle
* **Allow aspect ratio cropping** — customers crop to a fixed aspect ratio you define
**When to use**
* If you want customers to focus on a specific part of their image
* If you need consistent shapes for printed products (e.g. circular stickers, square prints)
* If you want to give customers more control over how their image appears
{% hint style="info" %}
Cropping happens on the customer's side before the file is uploaded, so the final file you receive will already be cropped to the selected shape.
{% endhint %}
{% hint style="warning" %}
If you combine both rules, make sure your **Image dimensions** limits match the cropping shape. For example, if you require "square-only cropping" but also set very different minimum width and height values, customers may struggle to upload an acceptable image.
{% endhint %}
#### 📹 Watch: Image Dimensions
See how to set minimum or maximum width and height for uploaded images — useful for print-on-demand and quality control.
{% embed url="" %}
