Home › Docs › Addons › Image Cropper
Image Cropper
$10 Non-destructive, Canva-style cropping for uploaded images and clipart.
Platforms: WooCommerce, OpenCart, PrestaShop & Shopware 6. Version: 1.1.5.
Every purchase is a single signed, install-ready ZIP that also includes full TypeScript/Vue source, sourcemaps, and build tooling (npm ci && npm run build) if you want to customize it yourself. Installs and updates through the in-app addon marketplace.
What Image Cropper does
Image Cropper adds a familiar, drag-to-crop interface for uploaded images and clipart in the Veyo product designer for WooCommerce, without ever discarding the original file. Crop state is stored on the design item itself, so it survives save, page reload, and undo.
Customers can re-crop any time before checkout — nothing is baked in destructively until the final print-ready export is generated.
How to enable Image Cropper
-
Buy the addon
Your Polar purchase email (and the Polar customer portal) contains the addon ZIP.
-
Upload it in the Veyo Apps screen
Open Veyo → Extensions and upload the ZIP. Veyo verifies the package and installs it.
-
Enable it
Toggle Image Cropper on. The crop action appears automatically on uploaded images and clipart.
How to use Image Cropper
-
Select an image or clipart layer
With the layer selected, click Crop in the image toolbar, or double-click the image on the canvas.
-
Drag to adjust the crop
A Crop image window opens with the picture and a frame with eight handles. Drag the handles to resize the frame, drag inside it to move it, or drag the dimmed area to move the picture. Choose a ratio (Original, Free, 1:1, 4:3, 3:4 or 16:9) and use the Zoom slider if needed.
-
Apply, or re-crop later
Click Done (or press Enter) to apply, or Cancel (Escape) to leave the image as it was. Reset returns the frame to the full image. Open Crop again any time to adjust it — the original image is never lost.
At a glance
| Version | 1.1.5 |
|---|---|
| Platforms | WordPress + WooCommerce, OpenCart 3 & 4, PrestaShop 8 & 9, and Shopware 6.6 / 6.7 |
| Requires | Veyo Product Personalizer 1.0.1 or later. No other addons. |
| Where settings live | No settings screen. It works automatically once the addon is active. |
| Server tools / outside services | None. It runs only in the designer, in the shopper’s browser, and contacts no outside service. |
What shoppers see
- A Crop button (tooltip Crop image) in the toolbar of a selected image or clipart (SVG) layer. Double-clicking the layer opens the same window.
- A Crop image window with the picture, a crop frame with eight handles and grid lines, a row of ratio buttons, a Zoom slider and Reset, Cancel and Done buttons. On phones it fills the screen.
- When the layer is cropped its box is resized to the cropped shape, keeping its center and its longer side, so a tall crop stays tall on the canvas.
- Applying a crop is one step in undo history, and the crop is saved with the design.
Settings
There are no settings to configure. The values below are fixed in the addon.
| Setting | Default | Range / options | What it does |
|---|---|---|---|
| Ratio | Original on an uncropped image; Free when re-opening an existing crop or after Reset | Original, Free, 1:1, 4:3, 3:4, 16:9 | Locks the frame’s shape while resizing. |
| Zoom | 1× | 1× to 4× | Zooms the picture inside the window. |
| Minimum frame size | 24 | Fixed | The frame cannot be made smaller than 24 units. |
| Applies to | Image and SVG layers | Fixed | Text, shapes and other layer types do not get the button. |
What you get in orders and production
The crop is stored with the design (as a normalized crop rectangle on the layer), so previews and the exported production files show the cropped picture while the original upload stays untouched. There is nothing to configure per order. See Orders & production files.
Data and privacy
- Shopper photo: cropped in the browser. Nothing is uploaded by the addon and no outside service is used.
- Stored on your server: only a few numbers inside the saved design (the crop rectangle and the layer size). The addon creates no tables, options or files.
- Uninstalling: removing the addon keeps the saved crop data in existing designs; without the addon those layers are shown with their stored crop but cannot be re-cropped. Uninstalling the whole of Veyo with Keep data when uninstalling off erases the Veyo tables, including saved designs. See Uninstalling & your data.
Troubleshooting
- There is no Crop button. The button appears only on image and SVG layers. Select the layer first, and check the addon is enabled in Extensions.
- Double-click does nothing. Double-clicking opens the crop window only on image and SVG layers.
- The window opens on an older picture. The cropper uses the full-size original only when it belongs to the same image as the one shown; an image that was background-removed or replaced is cropped as it is displayed.
- Done does nothing. Done applies only once the picture has finished loading in the window. Wait for the image to appear, or press Cancel and try again.
- The frame will not get smaller or larger. It stays inside the picture and cannot go below the minimum size; with a ratio selected the other side follows.
FAQ
Does cropping reduce image quality?
No — the crop is stored as a non-destructive transform on the design item; the original resolution is preserved for final export.
Does this work on clipart too, or only uploads?
Both. The crop tool applies to any image-based layer, including clipart from the Stock Images addon.
Installing, updating and removing
- Install: upload the ZIP in Extensions, then enable it. See Install addons.
- Update: upload the newer ZIP over the old one. Settings and data are kept. See Upgrading.
- Remove: Uninstall on the addon card removes its files and keeps its data, so reinstalling restores everything. See Uninstalling & your data.