# What changed in react-medium-image-zoom

> 24 changes in react-medium-image-zoom 4 to 5 from its official release notes, upgrade guides and advisories: 11 breaking, 3 new APIs and options. Each one cited. Sources checked 2026-10-23. HTML: https://unstale.sh/npm/react-medium-image-zoom/

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

## react-medium-image-zoom 5

### Breaking changes

- Renamed `closeText` to `a11yNameButtonUnzoom`. (5.0.0) — [release notes](https://github.com/rpearce/react-medium-image-zoom/releases/tag/v5.0.0)
- Renamed `openText` to `a11yNameButtonZoom`. (5.0.0) — [release notes](https://github.com/rpearce/react-medium-image-zoom/releases/tag/v5.0.0)
- Removed; specify the overlay color via CSS using `[data-rmiz-modal-overlay="visible"]`. (5.0.0) — [release notes](https://github.com/rpearce/react-medium-image-zoom/releases/tag/v5.0.0)
- Removed; specify the overlay color via CSS using `[data-rmiz-modal-overlay="hidden"]`. (5.0.0) — [release notes](https://github.com/rpearce/react-medium-image-zoom/releases/tag/v5.0.0)
- Sets `"type": "module"` for ESModule usage. (5.0.0) — [release notes](https://github.com/rpearce/react-medium-image-zoom/releases/tag/v5.0.0)
- Removed. (5.0.0) — [release notes](https://github.com/rpearce/react-medium-image-zoom/releases/tag/v5.0.0)
- Removed; specify transition duration via CSS using `[data-rmiz-modal-overlay]` and `[data-rmiz-modal-img]`. (5.0.0) — [release notes](https://github.com/rpearce/react-medium-image-zoom/releases/tag/v5.0.0)
- Removed. (5.0.0) — [release notes](https://github.com/rpearce/react-medium-image-zoom/releases/tag/v5.0.0)
- Removed. (5.0.0) — [release notes](https://github.com/rpearce/react-medium-image-zoom/releases/tag/v5.0.0)
- Removed. (5.0.0) — [release notes](https://github.com/rpearce/react-medium-image-zoom/releases/tag/v5.0.0)

### New APIs and options

- Added to customize the unzoom button. (5.0.0) — [release notes](https://github.com/rpearce/react-medium-image-zoom/releases/tag/v5.0.0)
- Added to customize the zoom button. (5.0.0) — [release notes](https://github.com/rpearce/react-medium-image-zoom/releases/tag/v5.0.0)
- Added to provide attributes for an image that should be loaded on zoom. (5.0.0) — [release notes](https://github.com/rpearce/react-medium-image-zoom/releases/tag/v5.0.0)

### Behavior and default changes

- Images must match the specified querySelector criteria to be found; elements with `aria-hidden="true"` are excluded. (5.0.0) — [release notes](https://github.com/rpearce/react-medium-image-zoom/releases/tag/v5.0.0)
- Improved zooming support for images, picture and figure elements, and div and span elements with background images. (5.0.0) — [release notes](https://github.com/rpearce/react-medium-image-zoom/releases/tag/v5.0.0)

### Fixes and other changes

- Removes invalid aria-owns usage from rendered markup. (5.4.8) — [release notes](https://github.com/rpearce/react-medium-image-zoom/releases/tag/v5.4.8)
- Opening or closing a zoom no longer shifts the page's scroll position, preventing scroll-driven UI from firing as though the user scrolled. (5.4.7) — [release notes](https://github.com/rpearce/react-medium-image-zoom/releases/tag/v5.4.7)
- Unzoom now restores the previous scroll position instantly, avoiding animation from the top of the document on pages with smooth scrolling. (5.4.6) — [release notes](https://github.com/rpearce/react-medium-image-zoom/releases/tag/v5.4.6)
- Fixes erratic zoom/pan when page height exceeds the viewport in Safari on iOS. (5.4.5) — [release notes](https://github.com/rpearce/react-medium-image-zoom/releases/tag/v5.4.5)
- The mirror effect on a zoomed image now works with transform: scaleX(-100%). (5.4.4) — [release notes](https://github.com/rpearce/react-medium-image-zoom/releases/tag/v5.4.4)
- Using controlled zoom and ZoomContent at the same time no longer breaks. (5.4.4) — [release notes](https://github.com/rpearce/react-medium-image-zoom/releases/tag/v5.4.4)
- Fixed compatibility with React server-side rendering. (5.4.3) — [release notes](https://github.com/rpearce/react-medium-image-zoom/releases/tag/v5.4.3)
- Fixed an issue involving an empty string being passed to the src attribute. (5.4.2) — [release notes](https://github.com/rpearce/react-medium-image-zoom/releases/tag/v5.4.2)

## react-medium-image-zoom 4

### Breaking changes

- The project was completely rewritten with breaking changes and a new API; see the README for migration details. (4.0.0) — [release notes](https://github.com/rpearce/react-medium-image-zoom/blob/HEAD/CHANGELOG.md)