NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
npm · #4357 most downloaded on npm
Display PDFs in your React app as easily as if they were images.
Last release 9 days ago
10 Sep 2026
Ships fairly regularly
a new release about every 2 months
Nearly every release is documented
notes for 60 of the last 60 stable releases
2 versions withdrawn
withdrawn after publishing
12 years old
157 releases · first in 2014
react and react-pdf are now properly declared as peerDependencies, not dependencies (#78). Thanks, @iamtommcc!
Fixed an issue that caused not to be properly updated on scale change.
<PageCanvas> not to be properly updated on scale change.One column per quarter.
Recovered compatibility with React <16.0.0 that have been lost in version v2.1.3. Sorry for inconvenience!
On development builds, React-PDF will now show all errors in the console. There's no more need of catching all errors manually (#73). Thanks for sugge
<Page>'s text content to be misaligned when the page was rotated sideways.Updated sample and test suites to use React 16.0.0.
<Page> components ideally should be a direct children of <Document> component (#65). Thanks, @Anenth!babel-runtime dependency has been moved from devDependencies to dependencies.Ensure that non-ES6 environments won't fail because of ES6-only version of merge-class-names.
merge-class-names.Added support for server-side rendering using Node.js.
Document, Page and Outline components (#58).Document, Page and Outline components (#59).Page component.data: URL (side note: that's how files are loaded if you import them using Webpack's file-loader).Blob resulting in callback loop (#54).See Upgrade guide from version 1.x to 2.x.
See Upgrade guide from version 1.x to 2.x.
Document component.Page components. They are meant to be rendered inside Document component. And yes, this means you can now render many pages at once!Outline component.Page component can be selected or read by a screen reader (nnarhinen/react-pdf#52). Rendering text layer is enabled by default, but you can disable it by using renderTextLayer flag.loadDocument, loadPage etc.) now return a promise for your convenience.onLoadSuccess of Document and Page components now pass pdf and page respectively to their success handlers, giving you access to full PDF.js API.rotate prop was passed. Now React-PDF renders pages in their default rotation as defined in PDF file.pdf.worker.js (nnarhinen/react-pdf#39).Warning: setState(...): Can only update a mounted or mounting component. if you unmount it while loading a file or rendering a page (#43).Updated dependencies to the newest versions. This also ensures that faulty PDF.js that failed to load files is blocked.
Document component would fail to render throwing uncaught error.onDocumentLoad callbacks were not properly cancelled on unmount, if the latter happened before the page loaded.npm package is now lighter as it does not contain unnecessary files.
babel-polyfill is no longer required to use react-pdf. Thanks, @Kerumen!
renderTextLayer={false} to Page component.ReferenceError: regeneratorRuntime is not defined that may have occurred on some environments (#39). Thanks, @Kerumen!Optimized NPM package. It no longer includes files not necessary for end user.
Warning: setState(...): Can only update a mounted or mounting component. if you unmount it while loading a file or rendering a page (#43).Added instructions for non-Webpack projects.
loadDocument, loadPage etc.) now return a promise for your convenience.pdf.worker.js (nnarhinen/react-pdf#39).Enhanced text layers alignment.
Outline component not properly getting item destination from PDF documents created in Microsoft Word.Fix page rendered too small on HiDPI devices.
Fixed vertical alignment of text layers.
Fix text layers not rotating with the page rotation.
PageCanvas component no longer need external CSS to render canvas properly.Page component now renders text layers! This means the text can be selected or read by a screen reader (nnarhinen/react-pdf#52).
Page component now renders text layers! This means the text can be selected or read by a screen reader (nnarhinen/react-pdf#52).You can now render table of contents using new Outline component.
Outline component.Page component not showing loader when switching pages.Now there's more React in React. React-PDF's structure has been completely rewritten (#27).
Document component.Page components. They are meant to be rendered inside Document component. And yes, this means you can now render many pages at once!onLoadSuccess of Document and Page components now return pdf and page respectively, giving you access to full PDF.js API.rotate prop was passed. Now React-PDF renders pages in their default rotation as defined in PDF file.Fix an issue with react-pdf test and sample pages using ../ as their React-PDF path, which caused Webpack to fail to build them unless you manually in
../ as their React-PDF path, which caused Webpack to fail to build them unless you manually installed Webpack in root project's directory.Fix an error that resulted in Module not found: 'worker-loader' error on non-Webpack environments.
Module not found: 'worker-loader' error on non-Webpack environments.Fixed an issue that could cause React-PDF to fail on non-ES6 environments.
You can now rotate the page using prop rotate. See README.md for more details.
rotate. See README.md for more details.A warning Accessing PropTypes via the main React package is deprecated will no longer appear
Accessing PropTypes via the main React package is deprecated will no longer appear (#29)Fix ES2015 imports not transpiled to commonJS in es5, that could cause disable some users not using Babel from using the module.
Added width, height, originalWidth, originalHeight and scale parameters to onPageLoad callback object (#22).
width, height, originalWidth, originalHeight and scale parameters to onPageLoad callback object (#22).Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Your coding agent can read these notes before it upgrades. Set up the MCP server →