# What changed in react-pdf

> 16 changes in react-pdf 10 to 11 from its official release notes, upgrade guides and advisories: 11 breaking, 1 security, 1 new APIs and options. Each one cited. Sources checked 2026-10-28. HTML: https://unstale.sh/npm/react-pdf/

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

## react-pdf 11

### Breaking changes

- Support for older browsers and Node.js versions has been dropped; consult the upgrade guide for details. (11.0.0) — [release notes](https://github.com/wojtekmaj/react-pdf/releases/tag/v11.0.0)
- In Suspense mode, plain file objects are compared by value. (11.0.0) — [release notes](https://github.com/wojtekmaj/react-pdf/releases/tag/v11.0.0)
- The callback now runs after asynchronous annotation rendering finishes. (11.0.0) — [release notes](https://github.com/wojtekmaj/react-pdf/releases/tag/v11.0.0)
- The PDF.js upgrade brings improvements to annotation rendering, image decoding, font conversion, text selection, accessibility, and performance. (11.0.0) — [release notes](https://github.com/wojtekmaj/react-pdf/releases/tag/v11.0.0)
- Several PDF.js APIs have changed, affecting users of pdfjs directly, document or page proxies, and custom data factories. (11.0.0) — [release notes](https://github.com/wojtekmaj/react-pdf/releases/tag/v11.0.0)
- React 19 is now required; support for React 16.8, 17, and 18 has been dropped. (11.0.0) — [release notes](https://github.com/wojtekmaj/react-pdf/releases/tag/v11.0.0)
- Suspense and Error Boundary support is enabled by default for Document, Page, Thumbnail, and Outline; set suspense={false} on Document to keep the previous loading and error behavior. (11.0.0) — [release notes](https://github.com/wojtekmaj/react-pdf/releases/tag/v11.0.0)

### New APIs and options

- Annotation rendering failures are reported through this callback. (11.0.0) — [release notes](https://github.com/wojtekmaj/react-pdf/releases/tag/v11.0.0)

### Behavior and default changes

- In Suspense mode, plain options objects are compared by value. (11.0.0) — [release notes](https://github.com/wojtekmaj/react-pdf/releases/tag/v11.0.0)

## react-pdf 10

### Breaking changes

- Data URLs in URL attributes returned by customTextRenderer are now disallowed. (10.5.0) — [release notes](https://github.com/wojtekmaj/react-pdf/releases/tag/v10.5.0)
- Moved from :root to .textLayer .highlight and is now semi-transparent. (10.5.0) — [release notes](https://github.com/wojtekmaj/react-pdf/releases/tag/v10.5.0)
- Moved from :root to .textLayer .highlight and is now semi-transparent. (10.5.0) — [release notes](https://github.com/wojtekmaj/react-pdf/releases/tag/v10.5.0)
- The text layer z-index changed from 2 to 0. (10.5.0) — [release notes](https://github.com/wojtekmaj/react-pdf/releases/tag/v10.5.0)

### Security

- HTML returned by customTextRenderer is sanitized. (10.4.1) — [release notes](https://github.com/wojtekmaj/react-pdf/releases/tag/v10.4.1)

### Fixes and other changes

- Fixed a crash when <Document /> was hidden and revealed by <Activity>. (10.5.0) — [release notes](https://github.com/wojtekmaj/react-pdf/releases/tag/v10.5.0)
- Fixed the text layer being misaligned with page content. (10.5.0) — [release notes](https://github.com/wojtekmaj/react-pdf/releases/tag/v10.5.0)