--- title: "2022.1 release notes" canonical_url: "https://www.nutrient.io/guides/web/release-notes/2022-1/" md_url: "https://www.nutrient.io/guides/web/release-notes/2022-1.md" last_updated: "2026-08-21T21:30:39.105Z" description: "Explore the latest API updates in PSPDFKit 2022.1.1 and ensure a smooth transition for your implementation." --- # PSPDFKit 2022.1.1 migration changes Version 2022.1.0 contains a bug that was immediately fixed in the next version, 2022.1.1. Use version 2022.1.1 instead of 2022.1.0. [PSPDFKit for Web 2022.1](https://www.nutrient.io/blog/pspdfkit-web-2022-1-new-ui-customization-api/) introduces several API changes. We recommend verifying your implementation to check if it needs updating. ## Configuration#pdf removed We removed the `Configuration#pdf` API, which has been deprecated since 2020.2.0, in favor of [`Configuration#document`](https://www.nutrient.io/api/web/interfaces/Configuration.html#document). Note that `Configuration#document` can be used as a drop-in replacement for the removed API, as it works exactly the same. If you used to set `Configuration#pdf` to pass a document URL or `ArrayBuffer` in the configuration, you only need to pass it in `Configuration#document` instead from now on. Before: ```js NutrientViewer.load({ pdf: "https://example.com/document.pdf" }); ``` Now: ```diff NutrientViewer.load({ - pdf: "https://example.com/document.pdf" + document: "https://example.com/document.pdf" }); ``` ## Javascript actions cannot open external URLs by default For security reasons, JavaScript actions will no longer be able to open URLs by default. The URLs will only open if the user has explicitly clicked on a URL. If you want to go back to the old behavior, you can use [`Configuration#onOpenURI`](https://www.nutrient.io/api/web/interfaces/Configuration.html#onopenuri): ```js NutrientViewer.load({ //... onOpenURI: () => true }); ``` ## Document Comparison button now hidden by default The Document Comparison toolbar button is now hidden by default; the reason is its behavior usually needs to be configured so as to be useful and address the required use case. If you need to enable it, you can do so in the configuration: ```js NutrientViewer.load({ toolbarItems: NutrientViewer.defaultToolbarItems.reduce((acc, it) => { if (it.type === "document-crop") { return acc.concat([it, { type: "document-comparison" }]); } return acc.concat([it]); }, []) }); ``` Or, after loading: ```js instance.setTolbarItems((ti) => { return ti.reduce((acc, it) => { if (it.type === "document-crop") { return acc.concat([it, { type: "document-comparison" }]); } return acc.concat([it]); }, []); }); ``` For a full list of changes, check out the [changelog](https://www.nutrient.io/guides/web/changelog.md#2022.1). ## Migrate PSPDFKit Server For more information, take a look at the [PSPDFKit Server 2022.1 migration guide](https://www.nutrient.io/guides/product-archives-and-deprecated-solutions.md). --- ## Related pages - [1 0](/guides/web/release-notes/1-0.md) - [1 1](/guides/web/release-notes/1-1.md) - [1 10](/guides/web/release-notes/1-10.md) - [1 11](/guides/web/release-notes/1-11.md) - [1 12](/guides/web/release-notes/1-12.md) - [1 13 1](/guides/web/release-notes/1-13-1.md) - [1 13](/guides/web/release-notes/1-13.md) - [1 14](/guides/web/release-notes/1-14.md) - [1 15](/guides/web/release-notes/1-15.md) - [1 16](/guides/web/release-notes/1-16.md) - [1 17](/guides/web/release-notes/1-17.md) - [1 18](/guides/web/release-notes/1-18.md) - [1 19](/guides/web/release-notes/1-19.md) - [1 2](/guides/web/release-notes/1-2.md) - [1 20](/guides/web/release-notes/1-20.md) - [1 3](/guides/web/release-notes/1-3.md) - [1 4](/guides/web/release-notes/1-4.md) - [1 5](/guides/web/release-notes/1-5.md) - [1 6](/guides/web/release-notes/1-6.md) - [1 7](/guides/web/release-notes/1-7.md) - [1 8](/guides/web/release-notes/1-8.md) - [1 9](/guides/web/release-notes/1-9.md) - [2017 3](/guides/web/release-notes/2017-3.md) - [2017 6](/guides/web/release-notes/2017-6.md) - [Update your PSPDFKit for Web to version 2017.7](/guides/web/release-notes/2017-7.md) - [Upgrade annotations in PSPDFKit Web 2017.8](/guides/web/release-notes/2017-8.md) - [Explore new features in PSPDFKit for Web 2017.9](/guides/web/release-notes/2017-9.md) - [New features in the 2018.1 migration guide](/guides/web/release-notes/2018-1.md) - [PSPDFKit for Web 2018.2 migration insights](/guides/web/release-notes/2018-2.md) - [Discover the new features in PSPDFKit for Web 2018.3](/guides/web/release-notes/2018-3.md) - [Explore PSPDFKit for Web 2018.4 features](/guides/web/release-notes/2018-4.md) - [Explore new features in PSPDFKit 2018.5](/guides/web/release-notes/2018-5.md) - [Explore PSPDFKit for Web 2018.6 enhancements](/guides/web/release-notes/2018-6.md) - [Explore the new features in PSPDFKit 2018.7](/guides/web/release-notes/2018-7.md) - [Key updates in PSPDFKit for Web 2019.1](/guides/web/release-notes/2019-1.md) - [2019 2](/guides/web/release-notes/2019-2.md) - [PSPDFKit for Web 2019.3 migration highlights](/guides/web/release-notes/2019-3.md) - [Essential updates in PSPDFKit for Web 2019.4](/guides/web/release-notes/2019-4.md) - [PSPDFKit for Web 2019.5 migration insights](/guides/web/release-notes/2019-5.md) - [Key changes in PSPDFKit for Web 2020.1](/guides/web/release-notes/2020-1.md) - [Seamless migration to PSPDFKit for Web 2020.2](/guides/web/release-notes/2020-2.md) - [Upgrade to PSPDFKit Web 2020.3 seamlessly](/guides/web/release-notes/2020-3.md) - [PSPDFKit Web and Server 2020.4 migration update](/guides/web/release-notes/2020-4.md) - [Unified CRUD API enhancements for easy migration](/guides/web/release-notes/2020-5.md) - [PSPDFKit Web 2020.6 migration insights](/guides/web/release-notes/2020-6.md) - [Upgrade to PSPDFKit for Web 2021.1 with ease](/guides/web/release-notes/2021-1.md) - [Seamlessly migrate to PSPDFKit for Web 2021.2](/guides/web/release-notes/2021-2.md) - [2021 3](/guides/web/release-notes/2021-3.md) - [PSPDFKit 2021.4 migration guide for seamless updates](/guides/web/release-notes/2021-4.md) - [Migration guide for PSPDFKit 2021.5](/guides/web/release-notes/2021-5.md) - [2021 6](/guides/web/release-notes/2021-6.md) - [Enhancements in PSPDFKit for Web 2022.2](/guides/web/release-notes/2022-2.md) - [Explore the new features of PSPDFKit for Web 2022.3](/guides/web/release-notes/2022-3.md) - [PSPDFKit for Web 2022.4 migration overview](/guides/web/release-notes/2022-4.md) - [Key improvements in PSPDFKit for Web 2022.5](/guides/web/release-notes/2022-5.md) - [Discover the key updates in PSPDFKit for Web 2023.1](/guides/web/release-notes/2023-1.md) - [PSPDFKit 2023.2 migration and updates](/guides/web/release-notes/2023-2.md) - [Key updates in PSPDFKit for Web 2023.3](/guides/web/release-notes/2023-3.md) - [Explore key updates in PSPDFKit for Web 2023.4](/guides/web/release-notes/2023-4.md) - [Key updates in PSPDFKit for Web 2023.5](/guides/web/release-notes/2023-5.md) - [Essential Nutrient Web SDK 2024.1 migration tips](/guides/web/release-notes/2024-1.md) - [2024 2](/guides/web/release-notes/2024-2.md) - [2024 3](/guides/web/release-notes/2024-3.md) - [2024 4](/guides/web/release-notes/2024-4.md) - [2024 5](/guides/web/release-notes/2024-5.md) - [2024 7](/guides/web/release-notes/2024-7.md) - [2024 8](/guides/web/release-notes/2024-8.md) - [Upgrading Nutrient Web SDK](/guides/web/release-notes/upgrading.md)