# What changed in jimp

> 16 changes in jimp 1 from its official release notes, upgrade guides and advisories: 16 breaking. Each one cited. Sources checked 2026-10-26. HTML: https://unstale.sh/npm/jimp/

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

## jimp 1

### Breaking changes

- Export methods are async, and getBase64 replaces getBase64Async. (1.0.0) — [upgrade guide](http://jimp-dev.github.io/jimp/guides/migrate-to-v1)
- Export methods are async, and getBuffer replaces getBufferAsync. (1.0.0) — [upgrade guide](http://jimp-dev.github.io/jimp/guides/migrate-to-v1)
- Encoding options such as quality are now passed to getBuffer when retrieving the encoded image, rather than set globally. (1.0.0) — [upgrade guide](http://jimp-dev.github.io/jimp/guides/migrate-to-v1)
- Read image height from image.height instead of image.getHeight(). (1.0.0) — [upgrade guide](http://jimp-dev.github.io/jimp/guides/migrate-to-v1)
- intToRGBA moved from Jimp to a named package export. (1.0.0) — [upgrade guide](http://jimp-dev.github.io/jimp/guides/migrate-to-v1)
- Jimp no longer uses a default export; import it as a named export. (1.0.0) — [upgrade guide](http://jimp-dev.github.io/jimp/guides/migrate-to-v1)
- The constructor now takes an options object, including width, height, and an optional background color. (1.0.0) — [upgrade guide](http://jimp-dev.github.io/jimp/guides/migrate-to-v1)
- Jimp.AUTO was removed because it was only needed for positional arguments. (1.0.0) — [upgrade guide](http://jimp-dev.github.io/jimp/guides/migrate-to-v1)
- Load an image or canvas data from a bitmap with Jimp.fromBitmap instead of using the constructor. (1.0.0) — [upgrade guide](http://jimp-dev.github.io/jimp/guides/migrate-to-v1)
- Load an image from a buffer with Jimp.fromBuffer instead of passing the buffer to the constructor. (1.0.0) — [upgrade guide](http://jimp-dev.github.io/jimp/guides/migrate-to-v1)
- Use Jimp.read to load images asynchronously from disk in Node, from a URL in the browser, or from a Buffer or ArrayBuffer. (1.0.0) — [upgrade guide](http://jimp-dev.github.io/jimp/guides/migrate-to-v1)
- Jimp.MIME_* constants moved to the named JimpMime export. (1.0.0) — [upgrade guide](http://jimp-dev.github.io/jimp/guides/migrate-to-v1)
- Read the image MIME type from image.mime instead of image.getMIME(). (1.0.0) — [upgrade guide](http://jimp-dev.github.io/jimp/guides/migrate-to-v1)
- resize now takes an options object instead of positional width and height arguments. (1.0.0) — [upgrade guide](http://jimp-dev.github.io/jimp/guides/migrate-to-v1)
- Read image width from image.width instead of image.getWidth(). (1.0.0) — [upgrade guide](http://jimp-dev.github.io/jimp/guides/migrate-to-v1)
- Export methods are async, and write replaces writeAsync. (1.0.0) — [upgrade guide](http://jimp-dev.github.io/jimp/guides/migrate-to-v1)