---
title: "React Native SDK migration guide | Veriff.com"
slug: "react-native-sdk-migration-guide"
description: "Step-by-step React Native SDK migration guide. Learn how to seamlessly update your SDK and ensure a smooth transition for your app."
updated: 2026-05-14T10:41:38Z
published: 2026-05-14T11:04:44Z
---

> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.veriff.com/llms.txt
> Use this file to discover all available pages before exploring further.

# React Native SDK migration guide

## Migrating to React Native SDK 13.0.0

**Following configurations are added:**

- `feedbackSuccess`
- `onFeedbackSuccess`
- `feedbackError`
- `onFeedbackError`

**Following configurations will be deprecated in the next major release:**

- `error` - replaced by `onFeedbackError`
- `success` - replaced by `onFeedbackSuccess`

## Migrating to React Native SDK 9.0.0

### Separate iOS framework for NFC scanning

Since 9.0.0 React Native SDK, the iOS NFC scanning logic is provided as a separate framework. Check out [**Enable NFC scanning**](https://devdocs.veriff.com/docs/react-native-sdk-guide#enable-nfc-scanning) guide.

## Migrating React Native SDK 2.0.0 to 3.0.0

### Updated Branding API

#### Following configurations are added

- `background`
- `onBackground`
- `onBackgroundSecondary`
- `onBackgroundTertiary`
- `primary`
- `onPrimary`
- `secondary`
- `onSecondary`
- `outline`
- `error`
- `success`

#### Following configurations are removed

- `themeColor`
- `backgroundColor`
- `primaryTextColor`
- `primaryButtonBackgroundColor`
- `bulletPoint`

#### Following configurations are renamed

We renamed the `buttonCornerRadius` to `buttonRadius`.

## Migrating to React Native SDK 2.0.0

#### Use new parameter `sessionUrl`

New API uses `sessionUrl` instead of a `sessionToken`. `sessionUrl` is a combination of **base URL** and **session token**.

#### Rename parameter `navigationBarImage` to `logo`

We renamed the `navigationBarImage` parameter in configuration to `logo`.

---

## Changelog

| Date | Description |
| --- | --- |
| May 14, 2026 | [Migrating to React Native SDK 13.0.0 info added](/v1/docs/react-native-sdk-migration-guide#migrating-to-react-native-sdk-9001) |
| Jun 19, 2025 | [Separate iOS framework for NFC scanning](/v1/docs/react-native-sdk-migration-guide#separate-ios-framework-for-nfc-scanning) section added |
| Mar 12, 2025 | Documentation published |

## Related

- [React Native SDK guide](/react-native-sdk-guide.md)
- [React Native changelog](/react-native-changelog.md)
- [Backwards compatible changes](/backwards-compatible-changes.md)
