📐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)

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.

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

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.

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.

📹 Watch: Image Dimensions

See how to set minimum or maximum width and height for uploaded images — useful for print-on-demand and quality control.