npm / react-pdf
react-pdf
What changed in react-pdf 10 to 11, from its official release notes, upgrade guides and advisories. Sources checked 2026-10-28.
11 breaking1 security1 new APIs and options1 behavior and defaults2 fixes and other
See which of these apply to your code, ranked, in your agent:
npx @unstale/cli initreact-pdf 119 changes
Breaking changes 7
Support for older browsers and Node.js versions has been dropped; consult the upgrade guide for details.
In Suspense mode, plain file objects are compared by value.
The callback now runs after asynchronous annotation rendering finishes.
The PDF.js upgrade brings improvements to annotation rendering, image decoding, font conversion, text selection, accessibility, and performance.
Several PDF.js APIs have changed, affecting users of pdfjs directly, document or page proxies, and custom data factories.
React 19 is now required; support for React 16.8, 17, and 18 has been dropped.
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.
New APIs and options 1
Annotation rendering failures are reported through this callback.
Behavior and default changes 1
In Suspense mode, plain options objects are compared by value.
react-pdf 107 changes
Breaking changes 4
Data URLs in URL attributes returned by customTextRenderer are now disallowed.
Moved from :root to .textLayer .highlight and is now semi-transparent.
Moved from :root to .textLayer .highlight and is now semi-transparent.
The text layer z-index changed from 2 to 0.
Security 1
HTML returned by customTextRenderer is sanitized.
Fixes and other changes 2
Fixed a crash when <Document /> was hidden and revealed by <Activity>.
Fixed the text layer being misaligned with page content.