For the complete documentation index, see llms.txt. This page is also available as Markdown.

βœ‚οΈHow to open the crop screen and control crop options?

  • Please go to the "Upload rules" tab while creating a field

  • Click + Add a rule, then under Customer experience select Image editor

  • The image editor is now added to your field. Under "Configure the image editor cropping behavior for uploaded files", choose how customers can crop their image:

  • Allow free-form cropping β€” customers can drag any shape or size they like. Best for general use when you don't need a fixed shape.

  • Allow square-only cropping β€” the crop is locked to a perfect 1:1 square. Great for square prints, coasters, and square mugs.

  • Allow circle-only cropping β€” the crop is locked to a circle. Great for buttons, badges, round stickers, and pet tags.

  • Allow aspect ratio cropping β€” the crop is locked to a specific ratio you choose, so every uploaded image matches your product's print dimensions.

  • To turn the crop screen off, click the trash icon on the Image editor rule to remove it.

Only one cropping style applies per field. The crop screen opens automatically after a customer uploads a file β€” if you allow multiple uploads, it opens once for each file. Make sure to test this on your storefront after saving.

πŸ“Ή Watch: Image Editor & Cropping

See the built-in image editor in action β€” customers can crop their photo into a square or circle before submitting.

Last updated