Editor

Enable extension

To enable the Editor extension, please visit: How can I add an Extension?

Config

After the extension is enabled on your subscription, you can configure it on each individual upload field:

A new Section for the Editor extension will be available.  You can enable it on your upload field:

Editor tools

You can configure the editor tools you want your customers to use on the uploaded images:

Each tool will show as it's own section in the image editor:

You can view a live example of the image editor:  Image editor extension

Crop shapes

The image editor support cropping custom shapes.  It will generate a png file where the cut out parts are transparent. 

To enable it check the "Shapes" setting:

You can add more shapes, select from the examples or add any SVG path to crop a specific shape:

You can view a live example of the shape cropping:  Image editor shapes

Large files

The image editor runs in the customer's browser. Before the upload can start, the full image has to be decoded and drawn onto a canvas element so it can be edited. Large files, for example, print-ready gang sheets of 300MB and more, or images with very large pixel dimensions, can exceed the memory the browser allows for a single image.

Recommended setup for print-ready files

Disable the Editor on upload fields that receive print-ready files. Without the editor, the file is uploaded directly to the storage and never passes through the browser canvas. In this setup uploads of up to 5GB are supported.

This is the recommended setup for artwork that the customer has already prepared for print, where cropping or editing in the storefront is not needed.

If you need the editor for other products, use a separate upload config for the print-ready files and disable the editor only there. You can also limit the accepted image resolution on the upload config, see: How can I only allow specific image resolutions?