---
title: "2021.6 release notes"
canonical_url: "https://www.nutrient.io/guides/web/release-notes/2021-6/"
md_url: "https://www.nutrient.io/guides/web/release-notes/2021-6.md"
last_updated: "2026-05-30T02:20:01.417Z"
description: "Learn about the API changes and migration steps for PSPDFKit for Web 2021.6, including updates to annotation, bookmark, and form field methods."
---

With [PSPDFKit for Web 2021.6](https://www.nutrient.io/blog/pspdfkit-web-2021-6-document-comparison-date-picker/), we removed a handful of APIs that have been deprecated since 2020.5.0. This update:

- Removes `Instance#createAnnotation`, `Instance#createBookmark`, and `Instance#createFormField` in favor of [`Instance#create`](https://www.nutrient.io/api/web/classes/NutrientViewer.Instance.html#create).

- Removes `Instance#saveAnnotations`, `Instance#saveBookmarks`, `Instance#saveComments`, `Instance#saveFormFields`, and `Instance#saveFormFieldValues` in favor of [`save`].

- Removes `Instance#updateAnnotation`, `Instance#updateBookmark`, and `Instance#updateFormField` in favor of [`Instance#update`](https://www.nutrient.io/api/web/classes/NutrientViewer.Instance.html#update).

- Removes `Instance#deleteAnnotations`, `Instance#deletebookmark`, and `Instance#deleteFormField` in favor of [`Instance#delete`](https://www.nutrient.io/api/web/classes/NutrientViewer.Instance.html#delete).

- Removes `Instance#ensureAnnotationSaved`, `Instance#ensureBookmarkSaved`, and `Instance#ensureFormFieldSaved` in favor of [`Instance#ensureChangesSaved`](https://www.nutrient.io/api/web/classes/NutrientViewer.Instance.html#ensurechangessaved).

- Removes `Instance#hasUnsavedAnnotations`, `Instance#hasUnsavedBookmarks`, `Instance#hasUnsavedComments`, `Instance#hasUnsavedFormFieldValues`, and `Instance#hasUnsavedFormFields` in favor of [`Instance#hasUnsavedChanges`](https://www.nutrient.io/api/web/classes/NutrientViewer.Instance.html#hasunsavedchanges).

Note that some of these deprecated APIs returned a single result, but the new API will always return an array. Make sure any of your code that relied on this behavior accesses the first element in the array.

Below is an example of how to use the new `Instance#update` API with a single annotation:

```js

instance.update([annotation]).then((annotations) => {
  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](https://www.nutrient.io/guides/web/changelog.md#2021.6).

## Migrate PSPDFKit Server

For more information, take a look at the [PSPDFKit Server 2021.6 migration guide](https://www.nutrient.io/guides/product-archives-and-deprecated-solutions.md).
---

## Related pages

- [1 1](/guides/web/release-notes/1-1.md)
- [1 12](/guides/web/release-notes/1-12.md)
- [1 0](/guides/web/release-notes/1-0.md)
- [1 11](/guides/web/release-notes/1-11.md)
- [1 15](/guides/web/release-notes/1-15.md)
- [1 2](/guides/web/release-notes/1-2.md)
- [1 3](/guides/web/release-notes/1-3.md)
- [1 14](/guides/web/release-notes/1-14.md)
- [1 13 1](/guides/web/release-notes/1-13-1.md)
- [1 10](/guides/web/release-notes/1-10.md)
- [1 13](/guides/web/release-notes/1-13.md)
- [1 4](/guides/web/release-notes/1-4.md)
- [1 9](/guides/web/release-notes/1-9.md)
- [1 7](/guides/web/release-notes/1-7.md)
- [2017 3](/guides/web/release-notes/2017-3.md)
- [1 5](/guides/web/release-notes/1-5.md)
- [1 8](/guides/web/release-notes/1-8.md)
- [1 6](/guides/web/release-notes/1-6.md)
- [2017 6](/guides/web/release-notes/2017-6.md)
- [Upgrade annotations in PSPDFKit Web 2017.8](/guides/web/release-notes/2017-8.md)
- [Update your PSPDFKit for Web to version 2017.7](/guides/web/release-notes/2017-7.md)
- [Explore new features in PSPDFKit for Web 2017.9](/guides/web/release-notes/2017-9.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 PSPDFKit for Web 2018.4 features](/guides/web/release-notes/2018-4.md)
- [New features in the 2018.1 migration guide](/guides/web/release-notes/2018-1.md)
- [Explore PSPDFKit for Web 2018.6 enhancements](/guides/web/release-notes/2018-6.md)
- [Explore new features in PSPDFKit 2018.5](/guides/web/release-notes/2018-5.md)
- [Explore the new features in PSPDFKit 2018.7](/guides/web/release-notes/2018-7.md)
- [PSPDFKit for Web 2019.3 migration highlights](/guides/web/release-notes/2019-3.md)
- [2019 2](/guides/web/release-notes/2019-2.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)
- [Essential updates in PSPDFKit for Web 2019.4](/guides/web/release-notes/2019-4.md)
- [Key updates in PSPDFKit for Web 2019.1](/guides/web/release-notes/2019-1.md)
- [Unified CRUD API enhancements for easy migration](/guides/web/release-notes/2020-5.md)
- [PSPDFKit for Web 2019.5 migration insights](/guides/web/release-notes/2019-5.md)
- [Upgrade to PSPDFKit Web 2020.3 seamlessly](/guides/web/release-notes/2020-3.md)
- [Upgrade to PSPDFKit for Web 2021.1 with ease](/guides/web/release-notes/2021-1.md)
- [PSPDFKit Web and Server 2020.4 migration update](/guides/web/release-notes/2020-4.md)
- [PSPDFKit Web 2020.6 migration insights](/guides/web/release-notes/2020-6.md)
- [Seamlessly migrate to PSPDFKit for Web 2021.2](/guides/web/release-notes/2021-2.md)
- [Enhancements in PSPDFKit for Web 2022.2](/guides/web/release-notes/2022-2.md)
- [PSPDFKit 2021.4 migration guide for seamless updates](/guides/web/release-notes/2021-4.md)
- [Explore the new features of PSPDFKit for Web 2022.3](/guides/web/release-notes/2022-3.md)
- [PSPDFKit 2022.1.1 migration changes](/guides/web/release-notes/2022-1.md)
- [2021 3](/guides/web/release-notes/2021-3.md)
- [Migration guide for PSPDFKit 2021.5](/guides/web/release-notes/2021-5.md)
- [Key updates in PSPDFKit for Web 2023.5](/guides/web/release-notes/2023-5.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)
- [Key updates in PSPDFKit for Web 2023.3](/guides/web/release-notes/2023-3.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)
- [2024 4](/guides/web/release-notes/2024-4.md)
- [2024 5](/guides/web/release-notes/2024-5.md)
- [Essential Nutrient Web SDK 2024.1 migration tips](/guides/web/release-notes/2024-1.md)
- [Explore key updates in PSPDFKit for Web 2023.4](/guides/web/release-notes/2023-4.md)
- [2024 8](/guides/web/release-notes/2024-8.md)
- [2024 3](/guides/web/release-notes/2024-3.md)
- [2024 2](/guides/web/release-notes/2024-2.md)
- [2024 7](/guides/web/release-notes/2024-7.md)
- [Upgrading Nutrient Web SDK](/guides/web/release-notes/upgrading.md)