# What changed in cropperjs

> 27 changes in cropperjs 1 to 2 from its official release notes, upgrade guides and advisories: 16 new APIs and options. Each one cited. Sources checked 2026-10-29. HTML: https://unstale.sh/npm/cropperjs/

To see which of these apply to a repository, run `npx @unstale/cli init` in it.

## cropperjs 2

### New APIs and options

- Adds border radius support for selection and shade elements. (2.3.0) — [release notes](https://github.com/fengyuanchen/cropperjs/releases/tag/v2.3.0)
- Adds the createCropper function for creating a new Cropper instance. (2.3.0) — [release notes](https://github.com/fengyuanchen/cropperjs/releases/tag/v2.3.0)
- Adds the maxInset property to cropper-image. (2.3.0) — [release notes](https://github.com/fengyuanchen/cropperjs/releases/tag/v2.3.0)
- Adds the minInset property to cropper-image. (2.3.0) — [release notes](https://github.com/fengyuanchen/cropperjs/releases/tag/v2.3.0)
- Adds the zoomAroundCenter property to cropper-image. (2.3.0) — [release notes](https://github.com/fengyuanchen/cropperjs/releases/tag/v2.3.0)
- Adds the maxInset property to cropper-selection. (2.3.0) — [release notes](https://github.com/fengyuanchen/cropperjs/releases/tag/v2.3.0)
- Adds the minInset property to cropper-selection. (2.3.0) — [release notes](https://github.com/fengyuanchen/cropperjs/releases/tag/v2.3.0)
- Adds the resizeAroundCenter property to cropper-selection. (2.3.0) — [release notes](https://github.com/fengyuanchen/cropperjs/releases/tag/v2.3.0)
- Adds the zoomAroundCenter property to cropper-selection. (2.3.0) — [release notes](https://github.com/fengyuanchen/cropperjs/releases/tag/v2.3.0)

### Behavior and default changes

- Enhances resize handling with initial dimensions tracking. (2.3.0) — [release notes](https://github.com/fengyuanchen/cropperjs/releases/tag/v2.3.0)
- Enhances selection handling for non-resizable elements. (2.3.0) — [release notes](https://github.com/fengyuanchen/cropperjs/releases/tag/v2.3.0)
- Improves selection coverage and boundary handling. (2.3.0) — [release notes](https://github.com/fengyuanchen/cropperjs/releases/tag/v2.3.0)

### Fixes and other changes

- Fixes the element staying 0×0 when src is set after connect. (2.3.1) — [release notes](https://github.com/fengyuanchen/cropperjs/releases/tag/v2.3.1)
- Handles the image load event for complete images. (2.3.0) — [release notes](https://github.com/fengyuanchen/cropperjs/releases/tag/v2.3.0)
- Preserves explicit selection dimensions on initial coverage. (2.3.0) — [release notes](https://github.com/fengyuanchen/cropperjs/releases/tag/v2.3.0)

## cropperjs 1

### New APIs and options

- Adds rounded crop boxes and canvases. (1.7.0) — [release notes](https://github.com/fengyuanchen/cropperjs/releases/tag/v1.7.0)
- Adds an option to move and resize the crop box relative to the drag start point. (1.7.0) — [release notes](https://github.com/fengyuanchen/cropperjs/releases/tag/v1.7.0)
- Adds an option to resize the crop box around its center. (1.7.0) — [release notes](https://github.com/fengyuanchen/cropperjs/releases/tag/v1.7.0)
- Creates a new Cropper instance without the new operator. (1.7.0) — [release notes](https://github.com/fengyuanchen/cropperjs/releases/tag/v1.7.0)
- Adds an error event when the target image fails to load. (1.7.0) — [release notes](https://github.com/fengyuanchen/cropperjs/releases/tag/v1.7.0)
- Adds a beforeDraw option for applying canvas filters or custom drawing before the cropped image is rendered. (1.7.0) — [release notes](https://github.com/fengyuanchen/cropperjs/releases/tag/v1.7.0)
- Adds an option to zoom around the center of the cropper. (1.7.0) — [release notes](https://github.com/fengyuanchen/cropperjs/releases/tag/v1.7.0)

### Fixes and other changes

- Ends an active crop when the window loses focus, such as when releasing the mouse outside an iframe. (1.7.0) — [release notes](https://github.com/fengyuanchen/cropperjs/releases/tag/v1.7.0)
- Fixes crop box creation when a diagonal drag begins with movement along only one axis. (1.7.0) — [release notes](https://github.com/fengyuanchen/cropperjs/releases/tag/v1.7.0)
- Fixes crop box jumps when resizing past the opposite edge with minimum dimensions set. (1.7.0) — [release notes](https://github.com/fengyuanchen/cropperjs/releases/tag/v1.7.0)
- Fixes squished images with EXIF rotation when image-orientation: none is set. (1.7.0) — [release notes](https://github.com/fengyuanchen/cropperjs/releases/tag/v1.7.0)
- Fixes tiny negative offsets returned due to floating-point errors. (1.7.0) — [release notes](https://github.com/fengyuanchen/cropperjs/releases/tag/v1.7.0)