---
title: "PSPDFKit 11.3 Migration Guide"
canonical_url: "https://www.nutrient.io/guides/ios/migration-guides/pspdfkit-11-3-migration-guide/"
md_url: "https://www.nutrient.io/guides/ios/migration-guides/pspdfkit-11-3-migration-guide.md"
last_updated: "2026-05-14T16:53:43.872Z"
description: "Learn how to upgrade your iOS or Mac Catalyst project to PSPDFKit 11.3, featuring the new PersistentAnnotationSetStore for enhanced saved annotations."
---

This guide covers updating an iOS or Mac Catalyst project from PSPDFKit 11.2 for iOS to PSPDFKit 11.3 for iOS. We encourage you to update as soon as possible, in order to take advantage of future new features and fixes.

## New Store for Saved Annotations

This change is related to the Saved Annotations feature that lets your users store and reuse their frequently used annotations. You can skip this part if the Saved Annotations feature is disabled in your app.

With PSPDFKit 11.3 for iOS, we introduced [`PersistentAnnotationSetStore`](https://www.nutrient.io/api/ios/documentation/pspdfkitui/persistentannotationsetstore) as the new default implementation of the [`AnnotationSetStore`](https://www.nutrient.io/api/ios/documentation/pspdfkitui/annotationsetstore) protocol, replacing the old [`KeychainAnnotationSetsStore`](https://www.nutrient.io/api/ios/documentation/pspdfkitui/keychainannotationsetsstore).

Due to the built-in limitations of the keychain services, the old keychain-based store was able to store only up to 4 KB of data. This much data could be easily filled by saving a handful of complex ink annotations or even just one high-quality image annotation. We found that exceeding this limit could occasionally corrupt the keychain entry and result in the loss of your Saved Annotations.

The new [`PersistentAnnotationSetStore`](https://www.nutrient.io/api/ios/documentation/pspdfkitui/persistentannotationsetstore) stores the Saved Annotations list in your app’s `Application Support` directory with file protection enabled. It doesn’t have any memory limit beyond the available storage space of the device.

The list of Saved Annotations your users previously added to the old keychain-based store will automatically be moved to the new [`PersistentAnnotationSetStore`](https://www.nutrient.io/api/ios/documentation/pspdfkitui/persistentannotationsetstore) to make sure it continues to be accessible.

Going forward, the new [`PersistentAnnotationSetStore`](https://www.nutrient.io/api/ios/documentation/pspdfkitui/persistentannotationsetstore) is our recommended implementation of the Saved Annotations store. It’s enabled by default, so _there’s nothing you need to do to start using it_.

However, if your app absolutely requires the extra bit of security that comes from storing the Saved Annotations list in the keychain, you can opt into it by setting the old keychain-based store as a default one during your app’s startup:

```swift

SavedAnnotationsViewController.sharedAnnotationStore = KeychainAnnotationSetsStore()

```

Note that continued use of `KeychainAnnotationSetsStore` increases the risk of exceeding the 4 KB memory limit by your users and, as a result, increases the risk of them losing access to their Saved Annotations list.

Refer to our [Knowledge Base article](https://www.nutrient.io/guides/ios/knowledge-base/how-do-i-programmatically-add-annotation-to-the-saved-annotations-list.md) to learn more about how to programmatically modify the list of Saved Annotations in your app.
---

## Related pages

- [14 9 Migration Guide](/guides/ios/migration-guides/14-9-migration-guide.md)
- [14 2 Migration Guide](/guides/ios/migration-guides/14-2-migration-guide.md)
- [Migrating From Apple Pdfkit](/guides/ios/migration-guides/migrating-from-apple-pdfkit.md)
- [Migrate to electronic signatures](/guides/ios/migration-guides/migrating-to-electronic-signatures.md)
- [Pspdfkit 10 3 Migration Guide](/guides/ios/migration-guides/pspdfkit-10-3-migration-guide.md)
- [Pspdfkit 10 4 Migration Guide](/guides/ios/migration-guides/pspdfkit-10-4-migration-guide.md)
- [Pspdfkit 11 5 Migration Guide](/guides/ios/migration-guides/pspdfkit-11-5-migration-guide.md)
- [Pspdfkit 10 Migration Guide](/guides/ios/migration-guides/pspdfkit-10-migration-guide.md)
- [Migrating To Advanced Digital Signatures Api](/guides/ios/migration-guides/migrating-to-advanced-digital-signatures-api.md)
- [Pspdfkit 13 3 Migration Guide](/guides/ios/migration-guides/pspdfkit-13-3-migration-guide.md)
- [Pspdfkit 13 Migration Guide](/guides/ios/migration-guides/pspdfkit-13-migration-guide.md)
- [Pspdfkit 12 2 Migration Guide](/guides/ios/migration-guides/pspdfkit-12-2-migration-guide.md)
- [Pspdfkit 12 3 Migration Guide](/guides/ios/migration-guides/pspdfkit-12-3-migration-guide.md)
- [Pspdfkit 3 Migration Guide](/guides/ios/migration-guides/pspdfkit-3-migration-guide.md)
- [Pspdfkit 11 4 Migration Guide](/guides/ios/migration-guides/pspdfkit-11-4-migration-guide.md)
- [Pspdfkit 4 Migration Guide](/guides/ios/migration-guides/pspdfkit-4-migration-guide.md)
- [Pspdfkit 5 Migration Guide](/guides/ios/migration-guides/pspdfkit-5-migration-guide.md)
- [Pspdfkit 6 5 Migration Guide](/guides/ios/migration-guides/pspdfkit-6-5-migration-guide.md)
- [Pspdfkit 12 Migration Guide](/guides/ios/migration-guides/pspdfkit-12-migration-guide.md)
- [Pspdfkit 6 Migration Guide](/guides/ios/migration-guides/pspdfkit-6-migration-guide.md)
- [Pspdfkit 9 2 Migration Guide](/guides/ios/migration-guides/pspdfkit-9-2-migration-guide.md)
- [Pspdfkit 7 6 Migration Guide](/guides/ios/migration-guides/pspdfkit-7-6-migration-guide.md)
- [Pspdfkit 9 4 Migration Guide](/guides/ios/migration-guides/pspdfkit-9-4-migration-guide.md)
- [Pspdfkit 9 5 Migration Guide](/guides/ios/migration-guides/pspdfkit-9-5-migration-guide.md)
- [Pspdfkit 9 3 Migration Guide](/guides/ios/migration-guides/pspdfkit-9-3-migration-guide.md)
- [Upgrading](/guides/ios/getting-started/upgrading.md)
- [Pspdfkit 9 Migration Guide](/guides/ios/migration-guides/pspdfkit-9-migration-guide.md)
- [Migrate to PSPDFKit 7 with ease](/guides/ios/migration-guides/pspdfkit-7-migration-guide.md)
- [PSPDFKit 8 migration guide for iOS developers](/guides/ios/migration-guides/pspdfkit-8-migration-guide.md)