Skip to main content
This migration guide covers significant changes in the SDK API that might affect your integration.
No custom views? If you have not overridden any SDK views or protocols, you typically only need to update the pod/package version — no code changes required.

[9.0.x] -> [9.1.0]

RTL Layout Support

Arabic locale support has been added. All SDK views now use leading/trailing constraints instead of left/right to properly support right-to-left (RTL) languages. If you have overridden any SDK views, you must migrate your custom constraints to use leading/trailing instead of left/right, otherwise runtime crashes may occur. For example:
  • leftAnchorleadingAnchor
  • rightAnchortrailingAnchor
  • NSLayoutConstraint with .left.leading
  • NSLayoutConstraint with .right.trailing
  • Text Alignment with .left.idenfyNatural
  • Transform Direction with HardcodedidenfyDirectionalTranslation:
You can check our updated, fully implemented views in the sample application.

[8.x.x] -> [9.0.0]

New iDenfy Privacy Policy View

New privacy policy view is a required step for onboarding users. PrivacyPolicyViewableV2 was completely redone: New Privacy Policy
A new color from IdenfyCommonColors is used in this view:

Country and Document Selection Steps Combined Into One View

A new Country & Document selection view was added, which combines the old two views into one. The new CountryAndDocumentSelectionViewable is added: New Country & Document selection
New colors from IdenfyCommonColors are used in this view:

Auto Country and Document Detection Feature

Along with this feature, a new card is presented in DocumentCameraViewableV2 to show detected country and supported documents for it. An updated view looks like this: New Country & Document selection

Updated UI for iDenfy Splash Screen

Both SplashScreenV2View and FaceAuthenticationSplashScreenV2View were redone, we use simple white and black colors without complicated iDenfy gradients: New Splash Screen
A new color from IdenfyCommonColors is used in this view:

[8.6.x] to [8.7.5]

Updated Country Selection UISearchBar to Support iOS 26

Follow this migration guide point if you have implemented custom views of CountrySelectionViewableV2.
Update the country search bar to the following to avoid iOS 26 rounding up the corners:

[8.6.2] to [8.6.3]

Updated Face Capture Oval Design

Face Oval V2
Follow this migration guide point if you have implemented custom views of FaceCameraViewableV2.
A new idenfyUIViewFaceOvalV3 oval class was added, which replaces idenfyUIViewFaceOval in FaceCameraViewableV2:
The idenfyUIViewFaceOval is still available but deprecated and will be removed in the future.

[8.5.x] to [8.6.0]

Added Realtime Blur Glare Detection in Document Capture

Follow this migration guide point if you have implemented custom views of DocumentCameraViewableV2.
With the latest realtime blur glare detection feature, a warning alert card was added to DocumentCameraViewableV2:

[8.5.x] to [8.5.7]

KYC Questionnaire FILE and IMAGE Questions Merged

ImageQuestionCell has been removed:

[8.4.x] to [8.5.0]

Added Face Detection Progress View to the Camera Drawer

Follow this migration guide point if you have implemented custom views of DrawerContentViewableV2.
With the latest face authentication auto capture feature, a progress view was added to DrawerContentViewableV2:

[8.3.x] to [8.4.0]

Removed Dynamic OnBoarding View

.withOnBoardingViewType(.multipleDynamic) option is no longer available in IdenfyUISettingsV2.
Follow this migration guide point if you have implemented custom views of DynamicCameraOnBoardingViewableV2.
The IdenfyViewsBuilderV2 will no longer have a .withDynamicCameraOnBoardingView option. Use .withStaticCameraOnBoardingView viewable instead. You can check new, fully implemented views in the sample application. The IdenfyDynamicCameraOnBoardingViewUISettingsV2 class has been removed. The static onBoarding view has its own IdenfyStaticCameraOnBoardingViewUISettingsV2 class.

[8.2.x] to [8.3.0]

Removed Instructions Drawer Option from Camera View

The instructions drawer has been removed. The top drawer will remain static as if instructions were disabled, and will only hold camera descriptions and the app bar. .withInstructions(IdenfyInstructionsType.drawer) option is no longer available in IdenfyUIBuilderV2.
Follow this migration guide point if you have implemented custom views of DrawerContentViewableV2, DocumentCameraViewableV2 or FaceCameraViewableV2.
The IdenfyViewsBuilderV2 will no longer have a .withDrawerContentView option. However, DocumentCameraViewableV2 and FaceCameraViewableV2 now include the DrawerContentViewableV2 view, which you can easily override:
The setupUIViewFaceOval() function of FaceCameraViewV2 has been refactored with a helper function to get the drawer height:
The DrawerContentViewableV2 protocol has changed:
As well as the CameraSessionDrawerDelegate:
You can check new, fully implemented views in the sample application. All colors and UI customizations related to the instructions drawer have been removed. See the updated UI customization files.

After Capturing Photos, Camera Results View Will Appear Instantly

Since the camera results view will appear instantly, it will show a loading spinner while the photo loads.
Follow this migration guide point if you have implemented custom views of CameraResultViewableV2.
The CameraResultViewableV2 now has an additional photoResultDetailsSpinner view you must implement:
Find fully implemented views in the sample application.

Changed Photo Cropping to Preserve Higher Resolution

The position of the document camera rectangle has been changed to match the logic of the Android SDK. Now the x position will be 0.05 * screen width. The CameraSessionsButtonsViewV2 height multiplier has been moved to a constant. It affects picture cropping. Make sure you change the height of idenfyUIViewContainerOfButtons by changing the idenfyCameraBottomControlsHeightMultiplier constant:
Find fully implemented views in the sample application.