---
title: "Migrate to PDF electronic signatures | Nutrient"
canonical_url: "https://www.nutrient.io/guides/web/migration-guides/migrating-to-electronic-signatures/"
md_url: "https://www.nutrient.io/guides/web/migration-guides/migrating-to-electronic-signatures.md"
last_updated: "2026-05-26T09:21:30.500Z"
description: "Learn how to migrate to electronic signatures with an improved UI and robust compatibility for a smoother signing experience."
---

# Migrate to electronic signatures

This guide covers migrating to the [Electronic Signatures](https://www.nutrient.io/../../signatures/overview/) component from the older signatures functionality that’s included with the Annotations component with licenses obtained in April 2021 or earlier. The older signatures user interface allows users to sign documents by drawing. Electronic Signatures includes a much-improved user interface that allows users to sign documents by drawing, selecting an image, or typing.

Electronic Signatures is a new component, so ensure your license includes Electronic Signatures. [Contact our Sales team](https://www.nutrient.io/contact-sales) if they haven’t already reached out to you.

If you don’t make API customizations and instead use Nutrient’s default signing experience, then there’s no migration needed, and Nutrient will automatically use the newer Electronic Signatures UI.

Signatures stored with the older functionality are fully compatible with Electronic Signatures.

Previously, a series of APIs were specific to handling ink signatures. With the introduction of Electronic Signatures, however, we expanded them so that they also support handling image signatures.

- The [`NutrientViewer.Configuration#populateInkSignatures`](https://www.nutrient.io/api/web/NutrientViewer.Configuration.html#populateInkSignatures) option has been renamed to [`NutrientViewer.Configuration#populateStoredSignatures`](https://www.nutrient.io/api/web/NutrientViewer.Configuration.html#populateStoredSignatures) and now supports specifying image annotations.

- The [`NutrientViewer.Instance#getInkSignatures`](https://www.nutrient.io/api/web/NutrientViewer.Instance.html#getInkSignatures) method has been renamed to [`NutrientViewer.Instance#getStoredSignatures`](https://www.nutrient.io/api/web/NutrientViewer.Instance.html#getStoredSignatures) and can also return [`NutrientViewer.Annotations.ImageAnnotation`](https://www.nutrient.io/api/web/NutrientViewer.Annotations.ImageAnnotation.html) records.

- The [`NutrientViewer.Instance#setInkSignatures`](https://www.nutrient.io/api/web/NutrientViewer.Instance.html#setInkSignatures) method has been renamed to [`NutrientViewer.Instance#setStoredSignatures`](https://www.nutrient.io/api/web/NutrientViewer.Instance.html#setStoredSignatures) and now supports specifying image annotations.

- The `NutrientViewer.InteractionMode.INK_SIGNATURE` value has been renamed to `NutrientViewer.InteractionMode.SIGNATURE`.

- The [`inkSignatures.create`](https://www.nutrient.io/api/web/NutrientViewer.Instance.html#~InkSignatureCreateEvent), [`inkSignatures.update`](https://www.nutrient.io/api/web/NutrientViewer.Instance.html#~InkSignatureUpdateEvent), [`inkSignatures.delete`](https://www.nutrient.io/api/web/NutrientViewer.Instance.html#~InkSignatureDeleteEvent), and [`inkSignatures.change`](https://www.nutrient.io/api/web/NutrientViewer.Instance.html#~InkSignatureChangeEvent) events have been renamed to [`storedSignatures.create`](https://www.nutrient.io/api/web/NutrientViewer.Instance.html#~StoredSignatureCreateEvent), [`storedSignatures.update`](https://www.nutrient.io/api/web/NutrientViewer.Instance.html#~StoredSignatureUpdateEvent), [`storedSignatures.delete`](https://www.nutrient.io/api/web/NutrientViewer.Instance.html#~StoredSignatureDeleteEvent), and [`storedSignatures.change`](https://www.nutrient.io/api/web/NutrientViewer.Instance.html#~StoredSignatureChangeEvent).

- The [`ink-signature`](https://www.nutrient.io/api/web/css-Toolbar.html#.PSPDFKit-Toolbar-Button-InkSignature-Annotation) toolbar item, which was part of [`NutrientViewer.defaultToolbarItems`](https://www.nutrient.io/api/web/NutrientViewer.html#.defaultToolbarItems), has been renamed to `signature`.

The picker for selecting existing signatures has been expanded with support for also previewing and choosing image signatures from it. Furthermore, users who trigger the existing signatures UI by activating the signature toolbar button won’t have their workflows affected by the new Electronic Signatures functionality, since the new UI is activated in the same manner.

With the introduction of Electronic Signatures, Nutrient Web SDK no longer automatically implements any kind of in-session storage of signatures added through the UI. To offer full flexibility and ease of persisting signatures across sessions, controls for choosing signatures to store are only available if a listener exists for the [`storedSignatures.create`](https://www.nutrient.io/api/web/NutrientViewer.Instance.html#~StoredSignatureCreateEvent) event.
---

## Related pages

- [Aria Labels Migration Guide](/guides/web/migration-guides/aria-labels-migration-guide.md)
- [2025 Blocks Ui Migration](/guides/web/migration-guides/2025-blocks-ui-migration.md)
- [Baseline Ui Migration Guide](/guides/web/migration-guides/baseline-ui-migration-guide.md)