---
title: "2022.3 release notes"
canonical_url: "https://www.nutrient.io/guides/web/release-notes/2022-3/"
md_url: "https://www.nutrient.io/guides/web/release-notes/2022-3.md"
last_updated: "2026-05-25T18:42:17.835Z"
description: "Learn about the updates in PSPDFKit for Web 2022.3, including persistent icon behavior and crucial bug fixes. Ensure your implementation is up to date!"
---

# Explore the new features of PSPDFKit for Web 2022.3

[PSPDFKit for Web 2022.3](https://www.nutrient.io/blog/pspdfkit-web-2022-3-new-pdf-form-creator-ui/) introduces some new APIs and includes several bug fixes. We recommend verifying your implementation to check if it needs updating.

## Notable changes

- (#33563) Updates the behavior of note, comment, and annotation note icons to keep dimensions persistent across zoom levels.

Note, comment, and annotation note icons used to resize across zoom levels. This behavior, although consistent with how annotations in general are rendered, made interacting with these icons difficult at some zoom levels, which in turn made the icon too small to access or too big that it concealed parts of the document.

To better align PSPDFKit for Web with other PSPDFKit platforms and other viewers, as well as to accommodate customer requests, we updated the note, comment, and annotation note icons to keep their dimensions persistent across zoom levels.

If you need to keep the former behavior, you can listen to the [`viewState.zoom.change`](https://www.nutrient.io/api/web/types/Events.ViewStateZoomChangeEvent.html) event and resize the bounding box of note annotations by multiplying their width and height by the current zoom level. You can also adjust their `top` and `left` coordinates accordingly.

Contact [support](https://support.nutrient.io/hc/en-us/requests/new) if you need any help with your use case.

- (#32553) Fixes an issue where we didn’t register an `annotationPresets.update` event when changing the ink eraser width.

Previously changing the width of the ink eraser tool didn’t trigger an [`annotationPresets.update`](https://www.nutrient.io/api/web/interfaces/Events.AnnotationPresetsUpdateEvent.html) event, but now it does.

The ink preset was updated to also support specifying an `inkEraserWidth` value that will determine the width of the ink eraser tool in the UI:

```js

const annotationPresets = NutrientViewer.defaultAnnotationPresets;
annotationPresets.ink = {
  inkEraserWidth: 40
};

```

Setting the default ink eraser width via [`NutrientViewer.Options.DEFAULT_INK_ERASER_CURSOR_WIDTH`](https://www.nutrient.io/api/web/variables/NutrientViewer.Options.DEFAULT_INK_ERASER_CURSOR_WIDTH.html) is now deprecated.

- (#32893) Adds support for customizing the color pickers for individual annotation properties.

This new API allows users to pass a configuration for each color dropdown rendered in the annotation toolbars. See [`configuration#annotationToolbarColorPresets`](https://www.nutrient.io/api/web/interfaces/Configuration.html#annotationtoolbarcolorpresets). This deprecates [`Options.COLOR_PRESETS`](https://www.nutrient.io/api/web/variables/NutrientViewer.Options.COLOR_PRESETS.html). With this release, using `Options.COLOR_PRESETS` will log a warning, but it’ll be removed in the next major release.

Use the new [`annotationToolbarColorPresets`](https://www.nutrient.io/api/web/types/AnnotationToolbarColorPresetsCallback.html) to pass a custom color array to the color dropdown:

```js

NutrientViewer.load({
  annotationToolbarColorPresets: function () {
    return {
      presets: [
        {
          color: new NutrientViewer.Color({ r: 0, g: 0, b: 0 }),
          localization: {
            id: "brightRed",
            defaultMessage: "Bright Red"
          }
        },
        {
          color: new NutrientViewer.Color({ r: 100, g: 100, b: 180 }),
          localization: {
            id: "deepBlue",
            defaultMessage: "Deep Blue"
          }
        },
        {
          color: new NutrientViewer.Color({ r: 243, g: 149, b: 0 }),
          localization: {
            id: "orange",
            defaultMessage: "Orange"
          }
        }
      ]
    };
  }
  //...
});

```

- (#34921) Updating form field values has always been possible using [`instance.setFormFieldValues()`](). However, with the Form Designer license component, it was also possible (involuntarily) by updating the form field itself:

```js

await instance.update(formField.set("value", "New value"));

```

Even though this approach seemed to work in most cases, it opens the door to multiple potential race conditions where form fields are updated in a way that invalidates the last form field value set, either by the API or by users.

Updating the form field value this way has been disabled, and now the only way to do it is through the corresponding method, to which you should change your implementation if it used to rely on the above approach:

```js

await instance.setFormFieldValues({
  [formField.name]: "New value"
});

```

More information can be found in our [guides](https://www.nutrient.io/guides/web/user-interface/color-picker/custom-presets.md) and in our [API description](https://www.nutrient.io/api/web/types/AnnotationToolbarColorPresetsCallback.html). For a full list of changes, check out the [changelog](https://www.nutrient.io/guides/web/changelog.md#2022.3).

## Migrate PSPDFKit Server

For more information, take a look at the [PSPDFKit Server 2022.3 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 14](/guides/web/release-notes/1-14.md)
- [1 11](/guides/web/release-notes/1-11.md)
- [1 13 1](/guides/web/release-notes/1-13-1.md)
- [1 13](/guides/web/release-notes/1-13.md)
- [1 2](/guides/web/release-notes/1-2.md)
- [1 12](/guides/web/release-notes/1-12.md)
- [1 5](/guides/web/release-notes/1-5.md)
- [1 9](/guides/web/release-notes/1-9.md)
- [1 8](/guides/web/release-notes/1-8.md)
- [1 3](/guides/web/release-notes/1-3.md)
- [1 4](/guides/web/release-notes/1-4.md)
- [1 15](/guides/web/release-notes/1-15.md)
- [1 6](/guides/web/release-notes/1-6.md)
- [1 7](/guides/web/release-notes/1-7.md)
- [2017 3](/guides/web/release-notes/2017-3.md)
- [Upgrade annotations in PSPDFKit Web 2017.8](/guides/web/release-notes/2017-8.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)
- [Explore PSPDFKit for Web 2018.4 features](/guides/web/release-notes/2018-4.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)
- [Discover the new features in PSPDFKit for Web 2018.3](/guides/web/release-notes/2018-3.md)
- [PSPDFKit for Web 2018.2 migration insights](/guides/web/release-notes/2018-2.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)
- [Upgrade to PSPDFKit Web 2020.3 seamlessly](/guides/web/release-notes/2020-3.md)
- [Key updates in PSPDFKit for Web 2019.1](/guides/web/release-notes/2019-1.md)
- [Essential updates in PSPDFKit for Web 2019.4](/guides/web/release-notes/2019-4.md)
- [2019 2](/guides/web/release-notes/2019-2.md)
- [PSPDFKit Web and Server 2020.4 migration update](/guides/web/release-notes/2020-4.md)
- [PSPDFKit for Web 2019.5 migration insights](/guides/web/release-notes/2019-5.md)
- [PSPDFKit for Web 2019.3 migration highlights](/guides/web/release-notes/2019-3.md)
- [Seamless migration to PSPDFKit for Web 2020.2](/guides/web/release-notes/2020-2.md)
- [Key changes in PSPDFKit for Web 2020.1](/guides/web/release-notes/2020-1.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)
- [Migration guide for PSPDFKit 2021.5](/guides/web/release-notes/2021-5.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)
- [2021 6](/guides/web/release-notes/2021-6.md)
- [PSPDFKit 2022.1.1 migration changes](/guides/web/release-notes/2022-1.md)
- [Enhancements in PSPDFKit for Web 2022.2](/guides/web/release-notes/2022-2.md)
- [PSPDFKit for Web 2022.4 migration overview](/guides/web/release-notes/2022-4.md)
- [Essential Nutrient Web SDK 2024.1 migration tips](/guides/web/release-notes/2024-1.md)
- [PSPDFKit 2023.2 migration and updates](/guides/web/release-notes/2023-2.md)
- [Discover the key updates in PSPDFKit for Web 2023.1](/guides/web/release-notes/2023-1.md)
- [Key improvements in PSPDFKit for Web 2022.5](/guides/web/release-notes/2022-5.md)
- [Explore key updates in PSPDFKit for Web 2023.4](/guides/web/release-notes/2023-4.md)
- [Key updates in PSPDFKit for Web 2023.3](/guides/web/release-notes/2023-3.md)
- [Key updates in PSPDFKit for Web 2023.5](/guides/web/release-notes/2023-5.md)
- [2024 2](/guides/web/release-notes/2024-2.md)
- [2024 3](/guides/web/release-notes/2024-3.md)
- [2024 7](/guides/web/release-notes/2024-7.md)
- [2024 4](/guides/web/release-notes/2024-4.md)
- [2024 5](/guides/web/release-notes/2024-5.md)
- [2024 8](/guides/web/release-notes/2024-8.md)
- [Upgrading Nutrient Web SDK](/guides/web/release-notes/upgrading.md)

