https://www.nutrient.io/guides/web/ Release notes for Nutrient Web SDK Fri, 15 May 2026 00:00:00 GMT Fri, 15 May 2026 00:00:00 GMT https://validator.w3.org/feed/docs/rss2.html https://github.com/jpmonette/feed en-US https://www.nutrient.io/guides/web/release-notes/2024-8/ https://www.nutrient.io/guides/web/release-notes/2024-8/ Thu, 01 Aug 2024 00:00:00 GMT https://www.nutrient.io/guides/web/release-notes/2024-7/ https://www.nutrient.io/guides/web/release-notes/2024-7/ Mon, 01 Jul 2024 00:00:00 GMT https://www.nutrient.io/guides/web/release-notes/2024-5/ https://www.nutrient.io/guides/web/release-notes/2024-5/ Wed, 01 May 2024 00:00:00 GMT https://www.nutrient.io/guides/web/release-notes/2024-4/ https://www.nutrient.io/guides/web/release-notes/2024-4/ Mon, 01 Apr 2024 00:00:00 GMT https://www.nutrient.io/guides/web/release-notes/2024-3/ https://www.nutrient.io/guides/web/release-notes/2024-3/ Fri, 01 Mar 2024 00:00:00 GMT https://www.nutrient.io/guides/web/release-notes/2024-2/ https://www.nutrient.io/guides/web/release-notes/2024-2/ Thu, 01 Feb 2024 00:00:00 GMT https://www.nutrient.io/guides/web/release-notes/2024-1/ https://www.nutrient.io/guides/web/release-notes/2024-1/ Mon, 01 Jan 2024 00:00:00 GMT https://www.nutrient.io/guides/web/release-notes/2023-5/ https://www.nutrient.io/guides/web/release-notes/2023-5/ Mon, 01 May 2023 00:00:00 GMT https://www.nutrient.io/guides/web/release-notes/2023-4/ https://www.nutrient.io/guides/web/release-notes/2023-4/ Sat, 01 Apr 2023 00:00:00 GMT https://www.nutrient.io/guides/web/release-notes/2023-3/ https://www.nutrient.io/guides/web/release-notes/2023-3/ Wed, 01 Mar 2023 00:00:00 GMT https://www.nutrient.io/guides/web/release-notes/2023-2/ https://www.nutrient.io/guides/web/release-notes/2023-2/ Wed, 01 Feb 2023 00:00:00 GMT https://www.nutrient.io/guides/web/release-notes/2023-1/ https://www.nutrient.io/guides/web/release-notes/2023-1/ Sun, 01 Jan 2023 00:00:00 GMT https://www.nutrient.io/guides/web/release-notes/2022-5/ https://www.nutrient.io/guides/web/release-notes/2022-5/ Sun, 01 May 2022 00:00:00 GMT https://www.nutrient.io/guides/web/release-notes/2022-4/ https://www.nutrient.io/guides/web/release-notes/2022-4/ Fri, 01 Apr 2022 00:00:00 GMT https://www.nutrient.io/guides/web/release-notes/2022-3/ https://www.nutrient.io/guides/web/release-notes/2022-3/ Tue, 01 Mar 2022 00:00:00 GMT https://www.nutrient.io/guides/web/release-notes/2022-2/ https://www.nutrient.io/guides/web/release-notes/2022-2/ Tue, 01 Feb 2022 00:00:00 GMT https://www.nutrient.io/guides/web/release-notes/2022-1/ https://www.nutrient.io/guides/web/release-notes/2022-1/ Sat, 01 Jan 2022 00:00:00 GMT https://www.nutrient.io/guides/web/release-notes/2021-6/ https://www.nutrient.io/guides/web/release-notes/2021-6/ Tue, 01 Jun 2021 00:00:00 GMT { const savedAnnotation = annotations[0]; }); ``` If you used to call `Instance#createAnnotation` to create a widget, and then attached it to a form using `Instance#createFormField`, you’ll now need to create the form field first. You’ll also need to generate and set the widget’s ID using `PSPDFKit#generateInstantId` so that you can reference the widget from the form field before it’s added to the document. Here’s an example of how you can do this using the new `Instance.html#create` API: ```js const annotation = new NutrientViewer.Annotations.WidgetAnnotation({ id: NutrientViewer.generateInstantId(), pageIndex: 0, formFieldName: "name", boundingBox: new NutrientViewer.Geometry.Rect({ left: 10, top: 20, width: 60, height: 40 }) }); const form = new NutrientViewer.FormFields.TextFormField({ name: "name", annotationIds: NutrientViewer.Immutable.List([annotation.id]), label: "A label" }); instance.create([annotation, form]); ``` By default, this makes signatures respect their aspect ratio when being resized by their corner handles. To opt out of this and go back to the old behavior, you can use the new `onAnnotationResizeStart` callback option: ```js NutrientViewer.load({ onAnnotationResizeStart: (event) => { if (event.annotation.isSignature && !event.isShiftPressed) { return { maintainAspectRatio: false }; } return undefined; } }); ``` For a full list of changes, check out the changelog. Learn about the API changes and migration steps for PSPDFKit for Web 2021.6, including updates to annotation, bookmark, and form field methods.]]> https://www.nutrient.io/guides/web/release-notes/2021-5/ https://www.nutrient.io/guides/web/release-notes/2021-5/ Sat, 01 May 2021 00:00:00 GMT !isIE11 && !isOldSafari }); ``` For a full list of changes, check out the changelog. Explore the new AP stream rendering in PSPDFKit 2021.5 and understand important migration steps for improved performance in older browsers.]]> https://www.nutrient.io/guides/web/release-notes/2021-4/ https://www.nutrient.io/guides/web/release-notes/2021-4/ Thu, 01 Apr 2021 00:00:00 GMT ; ``` Some of the frequently used types are: ```js type Instance = InstanceType; type Rect = InstanceType; type Color = InstanceType; type Annotation = InstanceType; type TextSelection = InstanceType; type ToolbarItems = InstanceType["toolbarItems"]; type List = ReturnType; type Awaited = T extends PromiseLike ? Awaited : T; type AnnotationsList = Awaited>; ``` We’re exploring ways to make this experience better in our upcoming releases. For a full list of changes, check out the changelog. Explore the new features of PSPDFKit 2021.4, including default JavaScript actions and improved TypeScript declarations for better integration and accuracy.]]> https://www.nutrient.io/guides/web/release-notes/2021-3/ https://www.nutrient.io/guides/web/release-notes/2021-3/ Mon, 01 Mar 2021 00:00:00 GMT https://www.nutrient.io/guides/web/release-notes/2021-2/ https://www.nutrient.io/guides/web/release-notes/2021-2/ Mon, 01 Feb 2021 00:00:00 GMT https://www.nutrient.io/guides/web/release-notes/2021-1/ https://www.nutrient.io/guides/web/release-notes/2021-1/ Fri, 01 Jan 2021 00:00:00 GMT { return it.type !== "export-pdf"; }); NutrientViewer.load({ ...configuration, toolbarItems }); ``` - (#25309) This release slightly changes the behavior of specifying a range of pages to search within when using the `NutrientViewer.Instance#search()` API. Previously, specifying both `startPageIndex` and `endPageIndex` made search results include matches from the start page index up until the end page index, without including those from the last page. Now, search results also include those from the end page index that’s specified. To keep the previous behavior, you’ll instead need to call `NutrientViewer.Instance#search`, passing `endPageIndex - 1` as the `endPageIndex` property value. - (#27856) You’ll no longer be allowed to change the `rootId` of a comment once it has been created. If you were updating the `rootId` before, make sure you create a new comment instead. - (#27443) This release prevents setting `NutrientViewer.ViewState#interactionMode` to a value that enables annotation creation with the UI when in read-only mode (`NutrientViewer.ViewState#readOnly` is `true`). The new interaction mode set via `Instance#setViewState` is set as `null` in this case, and a warning is emitted to the console. If you use PSPDFKit Server, make sure you read the 2021.1 server migration guide. For a full list of changes, check out the changelog. [pspdfkit for web 2021.1]: /blog/pspdfkit-web-2021-1-collaboration-permissions/ [mdn page]: https://developer.mozilla.org/en-US/docs/Web/API/IndexedDB_API [mozilla bug]: https://bugzilla.mozilla.org/show_bug.cgi?id=1469395 [wasm issue]: https://github.com/WebAssembly/spec/issues/821 [`nutrientviewer.instance#search()`]: /api/web/classes/NutrientViewer.Instance.html#search [2021.1 server migration guide]: /guides/product-archives-and-deprecated-solutions/ [changelog]: /guides/web/changelog/#2021.1 [web sdk 2020.6 release notes]: /guides/web/release-notes/2020-6/ Navigate changes in PSPDFKit for Web 2021.1 and optimize your configuration for new features like the Export PDF button. Update your migration strategy now!]]> https://www.nutrient.io/guides/web/release-notes/2020-6/ https://www.nutrient.io/guides/web/release-notes/2020-6/ Mon, 01 Jun 2020 00:00:00 GMT https://www.nutrient.io/guides/web/release-notes/2020-5/ https://www.nutrient.io/guides/web/release-notes/2020-5/ Fri, 01 May 2020 00:00:00 GMT https://www.nutrient.io/guides/web/release-notes/2020-4/ https://www.nutrient.io/guides/web/release-notes/2020-4/ Wed, 01 Apr 2020 00:00:00 GMT https://www.nutrient.io/guides/web/release-notes/2020-3/ https://www.nutrient.io/guides/web/release-notes/2020-3/ Sun, 01 Mar 2020 00:00:00 GMT { instance.setViewState(s => s.set("interactionMode", NutrientViewer.InteractionMode.INK_SIGNATURE) ); }); ``` If you use PSPDFKit Server, make sure you read the 2020.3 migration guide. For a full list of changes, check out the changelog. [pspdfkit for web 2020.3]: /blog/pspdfkit-adds-redaction-and-improved-digital-signatures-to-web/ [changelog]: /guides/web/changelog/#2020.3 [2020.3 migration guide]: /guides/product-archives-and-deprecated-solutions/ [web sdk 2020.2 release notes]: /guides/web/release-notes/2020-2/ Explore the PSPDFKit Web 2020.3 migration guide with key updates and changes for a smooth integration experience.]]> https://www.nutrient.io/guides/web/release-notes/2020-2/ https://www.nutrient.io/guides/web/release-notes/2020-2/ Sat, 01 Feb 2020 00:00:00 GMT https://www.nutrient.io/guides/web/release-notes/2020-1/ https://www.nutrient.io/guides/web/release-notes/2020-1/ Wed, 01 Jan 2020 00:00:00 GMT { instance.getFormFields().then(formFields => { const formField = formFields.find( formField => formField.name === event.annotation.formFieldName ); console.log(formField); }); }); ``` If you are using `event.formField`, here is the change you need to make: **Before** ```javascript instance.addEventListener("annotations.focus", event => { console.log(event.formField); }); instance.addEventListener("annotations.blur", event => { console.log(event.formField); }); ``` **After** ```javascript instance.addEventListener("annotations.focus", event => { instance.getFormFields().then(formFields => { const formField = formFields.find( formField => formField.name === event.annotation.formFieldName ); console.log(formField); }); }); instance.addEventListener("annotations.blur", event => { instance.getFormFields().then(formFields => { const formField = formFields.find( formField => formField.name === event.annotation.formFieldName ); console.log(formField); }); }); ``` - When the Digital Signatures component is included in the license, `NutrientViewer.Instance#exportPDF` will export signed documents as incrementally saved by default so as to prevent modifying signed data, which would invalidate the document’s digital signatures. However, setting the `incremental` flag to `false` will override this behavior. If the Digital Signatures component is not included in the license, the former behavior will be followed and signed documents will be exported as fully saved by default. In order to prevent signed data corruption in this case, the `incremental` flag should be explicitly set: ```js instance.exportPDF({ incremental: true }); ``` - Previously, the object returned by `NutrientViewer.ViewState#viewportPadding` had the `vertical` value under the `horizontal` property and vice versa. This has been now fixed. If you were relying on the previous returned value, you will need to adjust your implementation accordingly. - The order in which annotations are rendered has been modified. In previous versions, annotations of the same type would be rendered in the same layer, in the following order from back to front: - Text markup - Link - Text - Widget - Stamp - Image - Ink - Shape - Note Beginning with the current release, annotations will be rendered in the same order they are in the document, regardless of their type. New annotations will always be rendered on top of the last one that has been added. If your implementation relies on the former annotation rendering order, you may need to rearrange the order in which annotations are created so as to continue obtaining the same result. You would need to first create the annotations that you want to be rendered in the background, followed by the ones that you want to be rendered in the foreground. For example: First create text annotations, then stamp annotations, then ink and shape annotations, in that order. This way, your annotations will keep rendering in the order they had with the former behavior. If your annotations never overlap, this change will probably not affect your implementation at all. - The note annotation icon in the main toolbar has been updated. If you use PSPDFKit Server, make sure you read the 2020.1 migration guide. For a full list of changes, check out the changelog. [pspdfkit for web 2020.1]: /blog/pspdfkit-web-2020-1/ [`nutrientviewer.annotations.rectangleannotation#cloudyborderinsetrect`]: /api/web/classes/NutrientViewer.Annotations.RectangleAnnotation.html#cloudyborderinsetrect [`nutrientviewer.annotations.rectangleannotation#cloudyborderinset`]: /api/web/classes/NutrientViewer.Annotations.RectangleAnnotation.html#cloudyborderinset [`nutrientviewer.annotations.ellipseannotation#cloudyborderinsetrect`]: /api/web/classes/NutrientViewer.Annotations.EllipseAnnotation.html#cloudyborderinsetrect [`nutrientviewer.annotations.ellipseannotation#cloudyborderinset`]: /api/web/classes/NutrientViewer.Annotations.EllipseAnnotation.html#cloudyborderinset [`nutrientviewer.geometry.inset`]: /api/web/classes/NutrientViewer.Geometry.Inset.html [`nutrientviewer.geometry.rect`]: /api/web/classes/NutrientViewer.Geometry.Rect.html [`nutrientviewer.geometry.inset#fromvalue`]: /api/web/classes/NutrientViewer.Geometry.Inset.html#fromvalue [`nutrientviewer.instance#exportpdf`]: /api/web/classes/NutrientViewer.Instance.html#exportpdf [`nutrientviewer.viewstate#viewportpadding`]: /api/web/classes/NutrientViewer.ViewState.html#viewportpadding [changelog]: /guides/web/changelog/#2020.1 [2020.1 migration guide]: /guides/product-archives-and-deprecated-solutions/ [react intl]: https://github.com/formatjs/react-intl [standard `intl` web api]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl [web sdk 2019.5 release notes]: /guides/web/release-notes/2019-5/ Explore the significant updates in PSPDFKit Web 2020.1, including localization changes and deprecated features for seamless migration.]]> https://www.nutrient.io/guides/web/release-notes/2019-5/ https://www.nutrient.io/guides/web/release-notes/2019-5/ Wed, 01 May 2019 00:00:00 GMT https://www.nutrient.io/guides/web/release-notes/2019-4/ https://www.nutrient.io/guides/web/release-notes/2019-4/ Mon, 01 Apr 2019 00:00:00 GMT -*.js` files are used for internationalization files, e.g. `pspdfkit-lib/chunk-locale-de-*.js` for the German localization. - `chunk-standalone-*.js` is for all Standalone-specific artifacts. - `chunk-server-*.js` is for all Server-specific artifacts. Note that the last part of the file name is still a hash of its content. This ensures we don’t run into caching issues when artifacts are updated. - The icons in the toolbar were changed in order to shrink the toolbar height. Additionally, the icon size changed from 18x18 px to 24x24 px. - The WebAssembly and asm.js artifacts now have a content hash as part of the file name. This allows you to configure a long-term caching strategy and make use of advanced features like WASM code caching. The affected files are: - `pspdfkit-lib/pspdfkit.wasm` ➡️ `pspdfkit-lib/pspdfkit-.wasm` - `pspdfkit-lib/pspdfkit.wasm.js` ➡️ `pspdfkit-lib/pspdfkit-.wasm.js` - `pspdfkit-lib/pspdfkit.asm.js` ➡️ `pspdfkit-lib/pspdfkit-.asm.js` - `pspdfkit-lib/pspdfkit.asm.js.mem` ➡️ `pspdfkit-lib/pspdfkit-.asm.js.mem` - The thumbnail sidebar now comes with a changed layout. All public CSS classes can still be used to customize the styling: - `.PSPDFKit-Sidebar-Thumbnails-Page` - `.PSPDFKit-Sidebar-Thumbnails-Page-Image` - `.PSPDFKit-Sidebar-Thumbnails-Page-Label` - `.PSPDFKit-Sidebar-Thumbnails-Page-Selected` If you use PSPDFKit Server, make sure you read the 2019.4 server migration guide. For a full list of changes, check out the changelog. [pspdfkit for web 2019.4]: /blog/pspdfkit-web-2019-4/ [wasm code caching]: https://v8.dev/blog/wasm-code-caching [changelog]: /guides/web/changelog/#2019.4 [2019.4 server migration guide]: /guides/product-archives-and-deprecated-solutions/ [`nutrientviewer.defaulttoolbaritems`]: /api/web/variables/NutrientViewer.defaultToolbarItems.html [`nutrientviewer.configuration#theme`]: /api/web/interfaces/Configuration.html#theme [web sdk 2019.3 release notes]: /guides/web/release-notes/2019-3/ Explore key enhancements in PSPDFKit for Web 2019.4, including UI changes, a new Document Editor, and migration tips for seamless adaptation.]]> https://www.nutrient.io/guides/web/release-notes/2019-3/ https://www.nutrient.io/guides/web/release-notes/2019-3/ Fri, 01 Mar 2019 00:00:00 GMT https://www.nutrient.io/guides/web/release-notes/2019-2/ https://www.nutrient.io/guides/web/release-notes/2019-2/ Fri, 01 Feb 2019 00:00:00 GMT ` tag and want to maintain its current position, you could: - Query the current position in `onDisappear` and apply it again with `onAppear`, or - Move (`appendChild`) the ` https://www.nutrient.io/guides/web/release-notes/2019-1/ https://www.nutrient.io/guides/web/release-notes/2019-1/ Tue, 01 Jan 2019 00:00:00 GMT https://www.nutrient.io/guides/web/release-notes/2018-7/ https://www.nutrient.io/guides/web/release-notes/2018-7/ Sun, 01 Jul 2018 00:00:00 GMT .PSPDFKit-Toolbar-Button`. - We added a `rotation` property to annotations. This change shouldn’t affect current annotations. However, when using Server deployment, some documents might need to be uploaded again if the rotation is off. For a full list of changes, check out the changelog. [pspdfkit for web 2018.7]: /blog/pspdfkit-web-2018-7/ [changelog]: /guides/web/changelog/#2018.7 [2018.7 server migration guide]: /guides/product-archives-and-deprecated-solutions/ [web sdk 2018.6 release notes]: /guides/web/release-notes/2018-6/ Learn about customizable tooltips, enhanced DOM support, and other important features in PSPDFKit for Web 2018.7.]]> https://www.nutrient.io/guides/web/release-notes/2018-6/ https://www.nutrient.io/guides/web/release-notes/2018-6/ Fri, 01 Jun 2018 00:00:00 GMT https://www.nutrient.io/guides/web/release-notes/2018-5/ https://www.nutrient.io/guides/web/release-notes/2018-5/ Tue, 01 May 2018 00:00:00 GMT https://www.nutrient.io/guides/web/release-notes/2018-4/ https://www.nutrient.io/guides/web/release-notes/2018-4/ Sun, 01 Apr 2018 00:00:00 GMT https://www.nutrient.io/guides/web/release-notes/2018-3/ https://www.nutrient.io/guides/web/release-notes/2018-3/ Thu, 01 Mar 2018 00:00:00 GMT https://www.nutrient.io/guides/web/release-notes/2018-2/ https://www.nutrient.io/guides/web/release-notes/2018-2/ Thu, 01 Feb 2018 00:00:00 GMT https://www.nutrient.io/guides/web/release-notes/2018-1/ https://www.nutrient.io/guides/web/release-notes/2018-1/ Mon, 01 Jan 2018 00:00:00 GMT https://www.nutrient.io/guides/web/release-notes/2017-9/ https://www.nutrient.io/guides/web/release-notes/2017-9/ Fri, 01 Sep 2017 00:00:00 GMT https://www.nutrient.io/guides/web/release-notes/2017-8/ https://www.nutrient.io/guides/web/release-notes/2017-8/ Tue, 01 Aug 2017 00:00:00 GMT https://www.nutrient.io/guides/web/release-notes/2017-7/ https://www.nutrient.io/guides/web/release-notes/2017-7/ Sat, 01 Jul 2017 00:00:00 GMT https://www.nutrient.io/guides/web/release-notes/2017-6/ https://www.nutrient.io/guides/web/release-notes/2017-6/ Thu, 01 Jun 2017 00:00:00 GMT https://www.nutrient.io/guides/web/release-notes/2017-3/ https://www.nutrient.io/guides/web/release-notes/2017-3/ Wed, 01 Mar 2017 00:00:00 GMT https://www.nutrient.io/guides/web/release-notes/1-15/ https://www.nutrient.io/guides/web/release-notes/1-15/ Fri, 15 May 2026 00:00:00 GMT ({ render: () => createToolbar(instance), }), }, }, }); ``` After: ```js NutrientViewer.load({ ui: { tools: { main: (getInstance, id) => ({ render: () => createToolbar(getInstance()), }), }, }, }); ``` The previous signature handed slots a synchronous instance reference, which meant pre-load slots (`ui.loader` and `ui.passwordPrompt`) received `null` because the viewer hadn’t finished loading. With `getInstance()`, the same callback can read the live instance from any render call or event handler that fires after `NutrientViewer.load()` resolves — which is what unblocks the new configurable loader UI. The change applies to every `ui.*` slot, including: - Pre-load slots — `ui.loader`, `ui.passwordPrompt`. - Post-load slots — `ui.tools.main`, `ui.tools.contextual`, `ui.annotations.*`, `ui.signatures.*`, `ui.search`, `ui.documentEditor`, `ui.commentThread`, `ui.sidebar.*`. {% alert line="single-line" %} Minimum Document Engine version required: 1.5.6 {% /alert %} For a complete list of changes, bug fixes, and improvements, refer to the changelog. For previous release notes, refer to the Web SDK 1.14 release notes. We appreciate your feedback and contributions as we continue to enhance Nutrient Web SDK. [changelog]: /guides/web/changelog/#1.15.0 [web sdk 1.14 release notes]: /guides/web/release-notes/1-14/ [1.5.6]: /guides/document-engine/changelog/#1.5.6 [searchtype-api]: /api/web/enums/NutrientViewer.SearchType.html [abortsignal]: https://developer.mozilla.org/en-US/docs/Web/API/AbortSignal [ui-loader-api]: /api/web/interfaces/UI.Configuration.html#loader [support-form]: https://support.nutrient.io/hc/en-us/requests/new Lists important changes for Nutrient Web SDK 1.15]]> https://www.nutrient.io/guides/web/release-notes/1-14/ https://www.nutrient.io/guides/web/release-notes/1-14/ Fri, 15 May 2026 00:00:00 GMT https://www.nutrient.io/guides/web/release-notes/1-13-1/ https://www.nutrient.io/guides/web/release-notes/1-13-1/ Fri, 15 May 2026 00:00:00 GMT https://www.nutrient.io/guides/web/release-notes/1-13/ https://www.nutrient.io/guides/web/release-notes/1-13/ Fri, 15 May 2026 00:00:00 GMT https://www.nutrient.io/guides/web/release-notes/1-12/ https://www.nutrient.io/guides/web/release-notes/1-12/ Fri, 15 May 2026 00:00:00 GMT https://www.nutrient.io/guides/web/release-notes/1-11/ https://www.nutrient.io/guides/web/release-notes/1-11/ Fri, 15 May 2026 00:00:00 GMT https://www.nutrient.io/guides/web/release-notes/1-10/ https://www.nutrient.io/guides/web/release-notes/1-10/ Fri, 15 May 2026 00:00:00 GMT https://www.nutrient.io/guides/web/release-notes/1-9/ https://www.nutrient.io/guides/web/release-notes/1-9/ Fri, 15 May 2026 00:00:00 GMT https://www.nutrient.io/guides/web/release-notes/1-8/ https://www.nutrient.io/guides/web/release-notes/1-8/ Fri, 15 May 2026 00:00:00 GMT https://www.nutrient.io/guides/web/release-notes/1-7/ https://www.nutrient.io/guides/web/release-notes/1-7/ Fri, 15 May 2026 00:00:00 GMT https://www.nutrient.io/guides/web/release-notes/1-6/ https://www.nutrient.io/guides/web/release-notes/1-6/ Fri, 15 May 2026 00:00:00 GMT https://www.nutrient.io/guides/web/release-notes/1-5/ https://www.nutrient.io/guides/web/release-notes/1-5/ Fri, 15 May 2026 00:00:00 GMT Tab key, ensuring consistent accessibility across interaction methods. ### Enhanced annotation capabilities Version 1.5 brings significant refinements to the annotation experience, with a focus on color handling, mobile usability, and user interface consistency. #### Improved color handling The text color palette in annotations has been improved with a streamlined color selection interface. The transparent swatch option has been removed, creating a more intuitive color selection experience with only functional color options available. This refinement ensures that all available color choices behave consistently and predictably. Additionally, we’ve enhanced the 'None' color selection functionality for font and background colors when working with multiple text selections. The 'None' option can now be selected even if it’s currently active, and color selections are consistently applied across all selected text, ensuring uniform behavior across all annotation types. #### Enhanced mobile experience We’ve fixed an issue where the comment drawer didn’t open properly on mobile devices. This fix ensures comments are now accessible across all device types and screen sizes, allowing users to seamlessly interact with comment marker annotations in mobile view. #### User interface refinements We’ve fixed an issue where layout configuration icons didn’t update when custom icons were passed via API. This fix allows developers to maintain a consistent visual language throughout their applications by ensuring custom icons are properly displayed. We’ve also fixed an issue where users were able to submit blank typed signatures: The “Done” button is now disabled until at least one visible character is entered, ensuring signatures contain meaningful content and preventing potential errors. Additionally, we’ve addressed a problem where the Document Editor image gallery didn’t auto-scroll during drag operations. This fix restores the ability to drag pages beyond the visible viewport during page reordering. For example, when reordering pages in a multipage document, the editor now automatically scrolls when a dragged page reaches the edge of the visible area. ### Core functionality and document handling This release delivers substantial improvements to the core functionality of the SDK, with a focus on comments, document comparison, security, and rendering accuracy. #### Comments UI Previously, comments threads were always displayed in a floating sidebar to the side of the page, which wasn’t convenient as soon as the page was zoomed in and there wasn’t enough space left to show the comments without having to scroll the viewport. In this release, the comments sidebar is now only shown when there’s enough space to display it without scrolling. If there isn’t enough space, the comments are shown in a popover instead, which can be opened by clicking on the comment marker. This popover dialog was previously visible only in `FIT_TO_WIDTH` zoom mode. We understand that this change may not be ideal for all use cases, so we now provide an extension to the `NutrientViewer.ViewState` API that makes it possible to customize this behavior at any time by setting `NutrientViewer.ViewState#commentDisplay`: - `NutrientViewer.CommentDisplay.FITTING` — The default value; will show comments in a floating sidebar by the page side when there’s enough space to do so, and in a popover when there isn’t, and the marker annotation is selected. - `NutrientViewer.CommentDisplay.FLOATING` — Will always show comments in a floating sidebar by the page side. - `NutrientViewer.CommentDisplay.POPOVER` — Will always show comments in a popover when the marker annotation is selected. As an example of how it’s used, here’s how to set the `commentDisplay` so the comments UI behaves like in previous versions, always showing comments in a floating sidebar unless in `FIT_TO_WIDTH` zoom mode: ```js const instance = await NutrientViewer.load(config); instance.setViewState((viewState) => viewState.set("commentDisplay", NutrientViewer.CommentDisplay.FLOATING), ); instance.addEventListener( "viewState.change", function (viewState, previousViewState) { const zoom = typeof viewState.zoom === "object" ? viewState.zoom.zoomMode : viewState.zoom; const previousZoom = typeof previousViewState.zoom === "object" ? previousViewState.zoom.zoomMode : previousViewState.zoom; if ( previousZoom === zoom && viewState.commentDisplay === previousViewState.commentDisplay ) { return; } if ( zoom === NutrientViewer.ZoomMode.FIT_TO_WIDTH && viewState.commentDisplay !== NutrientViewer.CommentDisplay.POPOVER ) { instance.setViewState((viewState) => viewState.set("commentDisplay", NutrientViewer.CommentDisplay.POPOVER), ); } else if ( viewState.commentDisplay !== NutrientViewer.CommentDisplay.FLOATING ) { instance.setViewState((viewState) => viewState.set("commentDisplay", NutrientViewer.CommentDisplay.FLOATING), ); } }, ); ``` #### Enhanced document comparison and XFDF support Word-level text comparison has been added, providing more granular document comparison capabilities that allow users to identify changes with greater precision. Previously, all comparisons were done at the character level, which could result in unintuitive highlighting of changes. For example, changing “January” to “February” would show as a deletion of “Jan,” addition of “Febr,” and “uary” as unchanged. With word-level comparison, the entire word is highlighted as changed, creating a more intuitive and readable comparison. Configuration options for rich text when working with XFDF files have also been added, expanding the SDK’s flexibility when working with this format and ensuring consistent rich text handling across different document workflows. This enhancement allows for better propagation of rich text configuration from the Web SDK to Core and Document Engine backends when performing XFDF operations. #### Security and performance improvements The Content Security Policy (CSP) HTTP header required `unsafe-eval` to be set in recent versions. You may now use `wasm-unsafe-eval` instead. We’ve also updated GdPicture to version 14.3.9, bringing the latest improvements from this underlying technology to our SDK. #### Rendering and UI consistency Several rendering issues have been addressed to ensure accurate display of annotations and content: - Fixed an issue where text markup annotations were rendered with the wrong proportions when zoomed, and in the wrong direction on rotated pages. This fix ensures markup annotations like squiggly, strikethrough, and underline now maintain appropriate proportions regardless of zoom level, page rotation, or text size, improving overall readability. - Fixed an issue where moving a stamp annotation rotated at 45 degrees would resize it. This fix ensures stable dimensions for rotated stamps throughout all user interactions, preventing unwanted size changes during movement. - Fixed an issue where comment threads would appear clipped in narrow screen widths. This fix ensures comment boxes now remain fully visible and accessible, even when the viewport is narrow or when using high zoom levels. - Fixed an issue where the comments sidebar and popover were simultaneously visible in `FIT_TO_WIDTH` view mode. This fix creates a more consistent and less cluttered user interface. #### Form handling and stability - Fixed an issue where it wasn’t possible to correctly set the time in some time form fields. This fix ensures users can now properly set time values across all platforms, with consistent validation behavior and support for proper time formats on both desktop and mobile devices. - Fixed an issue where using some Form Creator and Measurements dropdowns would throw an error. This fix resolves problems with Shadow DOM compatibility, ensuring consistent behavior when creating and managing form fields and annotations. - Fixed an issue where the first new comment text field wouldn’t be focused when creating a comment, improving workflow efficiency. Additionally, we’ve fixed a crash that could occur when creating a text parser for a page with verbose logging enabled, ensuring consistent performance, even with complex document structures. {% alert line="single-line" %} Minimum Document Engine version required: 1.5.6 {% /alert %} For a complete list of changes, bug fixes, and performance improvements, refer to the changelog. For previous release notes, refer to the Web SDK 1.4 release notes. We appreciate your feedback and contributions as we continue to enhance Nutrient Web SDK. [changelog]: /changelog/web/#1.5.0 [web sdk 1.4 release notes]: /guides/web/release-notes/1-4/ [1.5.6]: /guides/document-engine/changelog/#1.5.6 [bui-migration]: /guides/web/migration-guides/baseline-ui-migration-guide/ Release notes for Nutrient Web SDK 1.5 highlighting new capabilities, API refinements, viewer/UI updates, and upgrade guidance.]]> https://www.nutrient.io/guides/web/release-notes/1-4/ https://www.nutrient.io/guides/web/release-notes/1-4/ Fri, 15 May 2026 00:00:00 GMT https://www.nutrient.io/guides/web/release-notes/1-3/ https://www.nutrient.io/guides/web/release-notes/1-3/ Fri, 15 May 2026 00:00:00 GMT ) now render as expected, and annotation tool states (e.g. selected or disabled) reflect correctly in the UI. ### Improved accessibility and metadata handling Nutrient Web SDK 1.3 brings better support for preserving accessibility-related metadata. `PDF/UA` tags are now retained when documents are edited, ensuring compliance with accessibility standards. The primary document language is also preserved, allowing assistive technologies to accurately interpret and present content. Alert and confirm dialogs are now properly centered, and focus is automatically directed to dialog buttons, improving keyboard accessibility. ### Expanded rendering and scripting capabilities This release adds support for several advanced features in the PDF JavaScript API, including `AFTime_KeystrokeEx`, the JavaScript `global` object, and page-level open and close actions. These additions enable more dynamic, form-driven documents with behavior that closely matches native PDF viewers. When converting Excel documents, developers can now specify maximum spreadsheet dimensions, and tile size is configurable for rendering optimization. We’ve also introduced a more resilient rendering path for callout and free text annotations to ensure appearance streams fit within annotation bounds. Loading speeds for Office documents have been improved, and launching Content Editor on pages with dense vector graphics (such as architectural plans) is now more responsive. ### Behavioral changes The `GoToAction` behavior has changed: It now sets destinations based on page references instead of page indexes. This means links will remain accurate, even if pages are moved or removed in the document editor. {% alert line="single-line" %} Minimum Document Engine version required: 1.5.6 {% /alert %} ### Breaking changes **PDF ID encoding correction** This release includes a fix to how PDF trailer IDs are encoded in the `pdfId` field of Instant JSON. Previously, the encoding was incorrectly truncated, resulting in shorter `pdfId` values. The corrected behavior now properly encodes the complete PDF ID. **Impact:** If you have existing Instant JSON files created with SDK versions prior to 1.3.0, they’ll contain `pdfId` values that won’t match when loading the same PDF in version 1.3.0 or later. This will result in a “Permanent PDF ID mismatch“ error. **Migration options** 1. **Remove pdfId validation** (recommended for most cases) — Strip the `pdfId` property from existing Instant JSON: ```javascript const { pdfId, ...jsonWithoutPdfId } = existingInstantJSON; NutrientViewer.load({ instantJSON: jsonWithoutPdfId, }); ``` 2. **Update existing Instant JSON** — Reexport your Instant JSON files using version 1.3.0 or later to generate corrected `pdfId` values. {% alert line="single-line" %} Removing `pdfId` is safe if your application ensures the correct PDF is loaded with its corresponding Instant JSON. {% /alert %} For a complete list of changes, bug fixes, and performance improvements, refer to the changelog. For previous release notes, refer to the Web SDK 1.2 release notes. We appreciate your feedback and contributions as we continue to enhance Nutrient Web SDK. [changelog]: /guides/web/changelog/#1.3.0 [web sdk 1.2 release notes]: /guides/web/release-notes/1-2/ [ai text comparison guide]: /guides/web/comparison/compare-text-ai/ [1.5.6]: /guides/document-engine/changelog/#1.5.6 Explore Nutrient Web SDK 1.3 changes, including new APIs, stability fixes, rendering improvements, and steps for upgrading existing apps.]]> https://www.nutrient.io/guides/web/release-notes/1-2/ https://www.nutrient.io/guides/web/release-notes/1-2/ Fri, 15 May 2026 00:00:00 GMT viewState.set("enableAlwaysScrollToZoom", true) ); ``` After: ```js // Always zoom on scroll wheel without requiring the Control key to be pressed. instance.setViewState( new NutrientViewer.ViewState({ zoom: { // Configure scroll wheel zoom behavior. wheelZoomMode: NutrientViewer.WheelZoomMode.ALWAYS // ... other zoom options } }) ); ``` ### Rich text annotations: Major enhancements This release delivers significant improvements to rich text annotations, making them more reliable, consistent, and user-friendly. Key enhancements - Adds support for applying font size and font family to individual text segments, enabling more precise text styling. - Standardizes behavior between background color and font color selections, ensuring consistent functionality across all color options. - Synchronizes rich text properties with underlying annotation metadata when all text is selected, ensuring consistent display. - Improves text formatting (bold, italic, underline) to work reliably during typing without disrupting line breaks or causing text to become hidden. - Enhances color management to maintain focus when changing colors, with proper updating of color swatches and consistent color application. - Preserves formatting and prevents data loss in multi-line text annotations during editing, deletion, and focus changes. - Maintains styling and formatting when pasting rich text content, with proper placement of pasted text. - Ensures consistent resizing behavior across all handles while preserving an annotation’s size, formatting, and alignment. - Improves keyboard focus management and restoration in the toolbar for consistent behavior across browsers. - Enhances AP stream generation with proper preservation of newlines and text formatting for improved document compatibility. Nutrient Web SDK 1.2 release notes detailing new features, annotation and UI updates, performance tuning, and migration considerations.]]> https://www.nutrient.io/guides/web/release-notes/1-1/ https://www.nutrient.io/guides/web/release-notes/1-1/ Fri, 15 May 2026 00:00:00 GMT https://www.nutrient.io/guides/web/release-notes/1-0/ https://www.nutrient.io/guides/web/release-notes/1-0/ Fri, 15 May 2026 00:00:00 GMT viewState.set("enableAlwaysScrollToZoom", true), ); ``` After: ```js instance.setViewState((viewState) => viewState.set("zoom", { // Configure scroll wheel zoom behavior. wheelZoomMode: NutrientViewer.WheelZoomMode.ALWAYS, // ... other zoom options. }), ); ``` ### UI updates This release introduces a major update to the Web SDK’s user interface, with the following UI sections migrated: - Link annotation toolbar - Image and signature annotation (image) toolbar - Stamp annotation toolbar - Text highlight and markup annotation toolbar - Content editor toolbar - Form creator toolbar - Ink eraser toolbar - Note annotation toolbar - Redaction toolbar - Shape annotation toolbars - Document crop toolbar Most customizations will continue to work as before, but if you notice anything unexpected and you were using CSS classes or CSS variables for customization, our Baseline UI migration guide offers helpful tips and guidance. ### Toolbars UI migration Annotation toolbars have undergone a significant overhaul to improve accessibility and customization capabilities, leveraging our in-house Baseline UI design system. These changes bring them in line with the updated look of other UI components, such as the sidebar and main toolbar, while also enhancing support for users’ accessibility requirements. ### Text Comparison API changes Several updates have been made to the Text Comparison API to ensure consistency with documentation and to unify data handling. 1. `TextBlock.rects` renamed to `TextBlock.rect` **Previous behavior:** `TextBlock.rects` was documented, but no rects were returned. **Impact:** Use `TextBlock.rect` instead of `TextBlock.rects`. 2. `TextBlock.rect` coordinates format updated **Previous behavior:** Coordinates were returned using a PDF coordinate system. **Impact:** If your application relied on PDF-style coordinates, update your logic to accommodate the new `x`, `y`, `width`, `height` format. 3. `Operation.originalTextBlocks` and `Operation.changedTextBlocks` return arrays **Previous behavior:** Only one `TextBlock` object was documented to be returned. **Impact:** These now return an array of `TextBlock` objects. Make sure your code handles multiple items. 4. `PageComparisonResult.originalPageIndex` and `PageComparisonResult.changedPageIndex` are optional **Previous behavior:** These properties were always present. **Impact:** Your code should now handle the possibility that these values may be undefined — particularly when comparing documents with differing page counts. ### Signing document hashes via DWS Processor API and Document Engine This release adds a new signing API, which enables direct hash signing with Document Engine and DWS Processor API when Web SDK operates client-side in the browser. An access token just needs to be passed to the `signDocument` method. Learn more in our guides on how to sign via DWS Processor API and how to sign via Document Engine. ### Attachments sidebar and preview A new attachments sidebar has been added. It displays a list of all files embedded in a PDF, and users can preview these files directly in the viewer or download them if the file format is unsupported. Previewing files is unavailable when using Document Engine — in this case, files can only be downloaded. {% alert line="single-line" %} Minimum Document Engine version required: 1.5.6 {% /alert %} For a complete list of changes, bug fixes, and performance improvements, refer to the changelog. For the previous release notes, see Web SDK 2024.7 release notes. We appreciate your feedback and contributions as we continue to enhance Nutrient Web SDK. [changelog]: /changelog/web/#1.0.0 [`nutrientviewer.viewstate#enablealwaysscrolltozoom`]: /api/web/classes/NutrientViewer.Instance.html#enablealwaysscrolltozoom [`viewstate.zoom api`]: /api/web/classes/NutrientViewer.ViewState.html#zoom [web sdk 2024.7 release notes]: /guides/web/release-notes/2024-7/ [dws sign]: /guides/web/signatures/digital-signatures/signature-lifecycle/sign-a-pdf-document-dws/ [de sign]: /guides/web/signatures/digital-signatures/signature-lifecycle/sign-a-pdf-document-document-engine/ [1.5.6]: /guides/document-engine/changelog/#1.5.6 [bui-migration]: /guides/web/migration-guides/baseline-ui-migration-guide/ Release notes for Nutrient Web SDK 1.0 covering the rebrand, new npm package, API changes, performance fixes, and upgrade guidance.]]> https://www.nutrient.io/guides/web/release-notes/upgrading/ https://www.nutrient.io/guides/web/release-notes/upgrading/ Fri, 15 May 2026 00:00:00 GMT