--- title: "PSPDFKit 13 Migration Guide" canonical_url: "https://www.nutrient.io/guides/ios/migration-guides/pspdfkit-13-migration-guide/" md_url: "https://www.nutrient.io/guides/ios/migration-guides/pspdfkit-13-migration-guide.md" last_updated: "2026-05-30T02:20:01.317Z" description: "Migration guide for Nutrient iOS SDK version 13 with breaking changes, API updates, and upgrade instructions." --- This guide covers updating an iOS or Mac Catalyst project from PSPDFKit 12.3 or PSPDFKit 12.4 to PSPDFKit 13. We encourage you to update as soon as possible, in order to take advantage of future new features and fixes. PSPDFKit 13 for iOS fully supports iOS 15, 16, and 17. Xcode 15 or later is required to use this version of the SDK. Learn more in our [version support](https://www.nutrient.io/guides/ios/announcements/version-support.md) guide. Refer to the [list of the removed APIs](#removed-apis) to find a replacement API. If you use removed APIs in your project, you’ll need to update to the replacement as soon as you update to PSPDFKit 13 for iOS. Refer to the [list of the deprecated APIs](#deprecated-apis) to find a replacement API. If you use deprecated APIs in your project, your project will continue to work, but the APIs will be removed in an upcoming version of PSPDFKit. ## Measurement Tools PSPDFKit 13 for iOS removes support for setting a calibration length for a distance measurement annotation from the annotation inspector. Calibrating lengths is now done via the new scale calibration annotation tool that uses the [`.measurementScaleCalibration`](https://www.nutrient.io/api/ios/documentation/pspdfkit/annotation/variant-swift.struct/measurementscalecalibration) annotation variant. The `AnnotationStyle.Key` values for the scale and precision to add these sections to the annotation inspector have been removed and replaced by [`AnnotationStyle.Key.measurementValueConfiguration`](https://www.nutrient.io/api/ios/documentation/pspdfkit/annotationstyle/key/measurementvalueconfiguration), which will present the new scale list UI. That's because scale and precision are now always grouped together. ## Removed APIs This is the list of all symbols that were removed in PSPDFKit 13 for iOS. If you use, implement, or override any of the following, take appropriate action. - **~~`AnnotationStyle.Key.measurementScale`~~** Use [`AnnotationStyle.Key.measurementValueConfiguration`](https://www.nutrient.io/api/ios/documentation/pspdfkit/annotationstyle/key/measurementvalueconfiguration) instead. - **~~`AnnotationStyle.Key.measurementPrecision`~~** Use [`AnnotationStyle.Key.measurementValueConfiguration`](https://www.nutrient.io/api/ios/documentation/pspdfkit/annotationstyle/key/measurementvalueconfiguration) instead. - **~~`AnnotationStyle.Key.measurementCalibration`~~** Use [`AnnotationStyle.Key.measurementValueConfiguration`](https://www.nutrient.io/api/ios/documentation/pspdfkit/annotationstyle/key/measurementvalueconfiguration) instead. ## Deprecated APIs This is the list of all symbols that were deprecated in PSPDFKit 13 for iOS. If you use, implement, or override any of the following, take appropriate action. - **~~`Document.measurementScale`~~** Use [`Document.activeMeasurementValueConfiguration.scale`](https://www.nutrient.io/api/ios/documentation/pspdfkit/document/activemeasurementvalueconfiguration) instead. - **~~`Document.measurementPrecision`~~** Use [`Document.activeMeasurementValueConfiguration.precision`](https://www.nutrient.io/api/ios/documentation/pspdfkit/document/activemeasurementvalueconfiguration) instead. - **~~`DocumentProvider.measurementScale`~~** Use [`Document.activeMeasurementValueConfiguration.scale`](https://www.nutrient.io/api/ios/documentation/pspdfkit/document/activemeasurementvalueconfiguration) instead. - **~~`DocumentProvider.measurementPrecision`~~** Use [`Document.activeMeasurementValueConfiguration.precision`](https://www.nutrient.io/api/ios/documentation/pspdfkit/document/activemeasurementvalueconfiguration) instead. --- ## Related pages - [14 9 Migration Guide](/guides/ios/migration-guides/14-9-migration-guide.md) - [Migrate to electronic signatures](/guides/ios/migration-guides/migrating-to-electronic-signatures.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) - [Pspdfkit 10 3 Migration Guide](/guides/ios/migration-guides/pspdfkit-10-3-migration-guide.md) - [Pspdfkit 12 2 Migration Guide](/guides/ios/migration-guides/pspdfkit-12-2-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 10 4 Migration Guide](/guides/ios/migration-guides/pspdfkit-10-4-migration-guide.md) - [Pspdfkit 11 3 Migration Guide](/guides/ios/migration-guides/pspdfkit-11-3-migration-guide.md) - [Pspdfkit 11 5 Migration Guide](/guides/ios/migration-guides/pspdfkit-11-5-migration-guide.md) - [Pspdfkit 12 3 Migration Guide](/guides/ios/migration-guides/pspdfkit-12-3-migration-guide.md) - [Pspdfkit 13 3 Migration Guide](/guides/ios/migration-guides/pspdfkit-13-3-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 12 Migration Guide](/guides/ios/migration-guides/pspdfkit-12-migration-guide.md) - [Pspdfkit 7 6 Migration Guide](/guides/ios/migration-guides/pspdfkit-7-6-migration-guide.md) - [Pspdfkit 11 4 Migration Guide](/guides/ios/migration-guides/pspdfkit-11-4-migration-guide.md) - [Pspdfkit 6 Migration Guide](/guides/ios/migration-guides/pspdfkit-6-migration-guide.md) - [Pspdfkit 6 5 Migration Guide](/guides/ios/migration-guides/pspdfkit-6-5-migration-guide.md) - [Pspdfkit 3 Migration Guide](/guides/ios/migration-guides/pspdfkit-3-migration-guide.md) - [Pspdfkit 9 2 Migration Guide](/guides/ios/migration-guides/pspdfkit-9-2-migration-guide.md) - [Pspdfkit 9 4 Migration Guide](/guides/ios/migration-guides/pspdfkit-9-4-migration-guide.md) - [Pspdfkit 9 3 Migration Guide](/guides/ios/migration-guides/pspdfkit-9-3-migration-guide.md) - [Pspdfkit 9 5 Migration Guide](/guides/ios/migration-guides/pspdfkit-9-5-migration-guide.md) - [Pspdfkit 9 Migration Guide](/guides/ios/migration-guides/pspdfkit-9-migration-guide.md) - [PSPDFKit 8 migration guide for iOS developers](/guides/ios/migration-guides/pspdfkit-8-migration-guide.md) - [Upgrading](/guides/ios/getting-started/upgrading.md) - [Migrate to PSPDFKit 7 with ease](/guides/ios/migration-guides/pspdfkit-7-migration-guide.md)