--- title: "2017.8 release notes" canonical_url: "https://www.nutrient.io/guides/web/release-notes/2017-8/" md_url: "https://www.nutrient.io/guides/web/release-notes/2017-8.md" last_updated: "2026-06-09T10:25:14.548Z" description: "Learn to seamlessly upgrade annotation IDs in PSPDFKit Web 2017.8 with our comprehensive migration guide." --- # Upgrade annotations in PSPDFKit Web 2017.8 PSPDFKit for Web 2017.8 changes annotation IDs from integers to strings. This requires that all clients (iOS, Android, and Web), along with the server, are updated to the latest version at the same time. If you’re maintaining an Instant setup, make sure to check out the [server migration guides](https://www.nutrient.io/guides/product-archives-and-deprecated-solutions.md). ### Annotation API changes - All [`Annotation`](https://www.nutrient.io/api/web/classes/NutrientViewer.Annotations.Annotation.html) subclasses now have a string value for the [`id`](https://www.nutrient.io/api/web/classes/NutrientViewer.Annotations.Annotation.html#id) field. This ID will still be generated automatically whenever [`Instance#createAnnotation`](https://www.nutrient.io/api/web/classes/NutrientViewer.Instance.html#createannotation) is called. - The concept of local ID and global ID is gone completely. The Web client can now generate a unique string ID, which is also used to reference the annotation when it is saved to Instant or Instant JSON. - `Instance#resolveLocalId` was removed and is now available as [`Instance#ensureAnnotationSaved`](https://www.nutrient.io/api/web/classes/NutrientViewer.Instance.html#ensurechangessaved). This method still accepts an annotation and will resolve the promise when the annotation is persisted. The `id` property of the annotation will now stay stable and will no longer be updated when the promise resolves. - The document format of [Instant JSON](https://www.nutrient.io/../../importing-exporting/instant-json/) no longer requires the `lastAnnotationId` property. Importing the previous version of Instant JSON (with number values for annotation IDs) using the [`Config#instantJSON`] option is still supported. When [`Instance#exportInstantJSON`] is called the next time, the format will automatically be upgraded. The IDs of existing annotations will simply be cast to string (so `-1` will become `"-1"`). For more details, check out our updated [annotation](https://www.nutrient.io/../../annotations/introduction-to-annotations/) and [Instant JSON] guides. For a full list of changes, check out the [changelog](https://www.nutrient.io/guides/web/changelog.md#2017.8). --- ## Related pages - [1 0](/guides/web/release-notes/1-0.md) - [1 10](/guides/web/release-notes/1-10.md) - [1 12](/guides/web/release-notes/1-12.md) - [1 1](/guides/web/release-notes/1-1.md) - [1 13](/guides/web/release-notes/1-13.md) - [1 11](/guides/web/release-notes/1-11.md) - [1 13 1](/guides/web/release-notes/1-13-1.md) - [1 15](/guides/web/release-notes/1-15.md) - [1 14](/guides/web/release-notes/1-14.md) - [1 4](/guides/web/release-notes/1-4.md) - [1 16](/guides/web/release-notes/1-16.md) - [1 2](/guides/web/release-notes/1-2.md) - [1 6](/guides/web/release-notes/1-6.md) - [1 3](/guides/web/release-notes/1-3.md) - [1 7](/guides/web/release-notes/1-7.md) - [1 5](/guides/web/release-notes/1-5.md) - [2017 3](/guides/web/release-notes/2017-3.md) - [1 8](/guides/web/release-notes/1-8.md) - [2017 6](/guides/web/release-notes/2017-6.md) - [1 9](/guides/web/release-notes/1-9.md) - [PSPDFKit for Web 2018.2 migration insights](/guides/web/release-notes/2018-2.md) - [Explore new features in PSPDFKit for Web 2017.9](/guides/web/release-notes/2017-9.md) - [Update your PSPDFKit for Web to version 2017.7](/guides/web/release-notes/2017-7.md) - [New features in the 2018.1 migration guide](/guides/web/release-notes/2018-1.md) - [Explore PSPDFKit for Web 2018.4 features](/guides/web/release-notes/2018-4.md) - [Discover the new features in PSPDFKit for Web 2018.3](/guides/web/release-notes/2018-3.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) - [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) - [Essential updates in PSPDFKit for Web 2019.4](/guides/web/release-notes/2019-4.md) - [Explore new features in PSPDFKit 2018.5](/guides/web/release-notes/2018-5.md) - [PSPDFKit for Web 2019.3 migration highlights](/guides/web/release-notes/2019-3.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) - [Upgrade to PSPDFKit for Web 2021.1 with ease](/guides/web/release-notes/2021-1.md) - [Upgrade to PSPDFKit Web 2020.3 seamlessly](/guides/web/release-notes/2020-3.md) - [Seamlessly migrate to PSPDFKit for Web 2021.2](/guides/web/release-notes/2021-2.md) - [Seamless migration to PSPDFKit for Web 2020.2](/guides/web/release-notes/2020-2.md) - [Migration guide for PSPDFKit 2021.5](/guides/web/release-notes/2021-5.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) - [Unified CRUD API enhancements for easy migration](/guides/web/release-notes/2020-5.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) - [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) - [PSPDFKit 2022.1.1 migration changes](/guides/web/release-notes/2022-1.md) - [Explore the new features of PSPDFKit for Web 2022.3](/guides/web/release-notes/2022-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) - [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) - [Explore key updates in PSPDFKit for Web 2023.4](/guides/web/release-notes/2023-4.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 4](/guides/web/release-notes/2024-4.md) - [2024 3](/guides/web/release-notes/2024-3.md) - [Key updates in PSPDFKit for Web 2023.5](/guides/web/release-notes/2023-5.md) - [2024 8](/guides/web/release-notes/2024-8.md) - [2024 7](/guides/web/release-notes/2024-7.md) - [2024 5](/guides/web/release-notes/2024-5.md) - [Upgrading Nutrient Web SDK](/guides/web/release-notes/upgrading.md)