---
title: "Nutrient React Native SDK 3 migration guide"
canonical_url: "https://www.nutrient.io/guides/react-native/migration-guides/react-native-3-migration-guide/"
md_url: "https://www.nutrient.io/guides/react-native/migration-guides/react-native-3-migration-guide.md"
last_updated: "2026-05-27T21:01:12.750Z"
description: "Learn how to migrate to Nutrient React Native SDK 3.0."
---

**Older versions available**: If you don’t want to migrate your project to version 3 yet, older versions can still be accessed using the standard GitHub URL. For version 2.19.1, use the following in your `package.json` file: `"react-native-pspdfkit": "github:PSPDFKit/react-native#2.19.1"`

This guide covers migrating to Nutrient React Native SDK 3. This release includes a new package name and updated component and API names to match our new branding.

## Package name

Nutrient React Native SDK’s package has changed to `@nutrient-sdk/react-native`. Update your application’s `package.json` file to reference the new package, which is now also available from npmjs.com:

```diff

- "react-native-pspdfkit": "github:PSPDFKit/react-native",

+ "@nutrient-sdk/react-native": "~3.0.0",

```

To prevent duplicate type errors, you’ll be required to uninstall the old `@nutrient-sdk/react-native` package completely and install the new package. It’s usually also a good idea to remove your `node_modules` directory and install your dependencies again using `yarn install` or `npm install`.

Due to the new package name and component rebranding, all import statements will need to be updated to point at the new package name — for example:

```diff

- import PSPDFKitView, { NotificationCenter } from 'react-native-pspdfkit';

+ import NutrientView, { NotificationCenter } from '@nutrient-sdk/react-native';

```

## Component and APIs

The main component to use in your implementation has been renamed from `PSPDFKitView` to `NutrientView`:

```diff

- <PSPDFKitView

+ <NutrientView
	document={DOCUMENT}
	configuration={{
		showThumbnailBar: 'scrollable',
		pageTransition: 'scrollContinuous',
		scrollDirection: 'vertical'
	}}
	ref={pdfRef}
	fragmentTag="PDF1"
	style={{flex: 1}}
/>

```

The main native module that hosts some of the core APIs has been renamed from `PSPDFKit` to `Nutrient`:

```diff

- export const PSPDFKit = NativeModules.PSPDFKit;

+ export const Nutrient = NativeModules.Nutrient;

- PSPDFKit.setLicenseKey("YOUR_LICENSE_KEY");

+ Nutrient.setLicenseKey("YOUR_LICENSE_KEY");

```

## Native dependencies

After rebranding to Nutrient, our Maven dependency URL also changed. In your application’s `build.gradle` file found inside the `android` directory, apply the following update:

You must first [log in to the Nutrient Portal](https://my.nutrient.io/users/sign_in) before accessing the Maven repository.

```diff

allprojects {
    repositories {
        google()
        mavenLocal()
        mavenCentral()
        maven {

-            url 'https://my.pspdfkit.com/maven/'

+            url 'https://my.nutrient.io/maven/'
        }
    }
}

```

If you’re setting your own license key on Android using the `AndroidManifest.xml` file, you’ll need to use the new keys:

```diff

<application>

- <meta-data

- android:name="pspdfkit_automatic_initialize"

- android:value="true" />

- <meta-data

- android:name="pspdfkit_license_key"

- android:value="YOUR_LICENSE_KEY_GOES_HERE" />

+ <meta-data

+ android:name="nutrient_automatic_initialize"

+ android:value="true" />

+ <meta-data

+ android:name="nutrient_license_key"

+ android:value="YOUR_LICENSE_KEY_GOES_HERE" />
</application>

```

Since the 2.8 release, the iOS dependency has been managed by the React Native SDK, but if you’re still importing the SDK inside your application’s Podfile, update the URLs:

```diff

- pod "PSPDFKit", podspec: "https://my.pspdfkit.com/pspdfkit-ios/nightly.podspec"

- pod "Instant",  podspec: "https://my.pspdfkit.com/instant/latest.podspec"

+  pod "PSPDFKit", podspec: "https://my.nutrient.io/pspdfkit-ios/nightly.podspec"

+  pod "Instant", podspec: "https://my.nutrient.io/instant/nightly.podspec"

```

For more information, refer to the [Nutrient React Native SDK 3 changelog](https://www.nutrient.io/guides/react-native/changelog.md#3.0).
---

## Related pages

- [React Native 2 13 Migration Guide](/guides/react-native/migration-guides/react-native-2-13-migration-guide.md)
- [React Native 2 12 Migration Guide](/guides/react-native/migration-guides/react-native-2-12-migration-guide.md)
- [React Native 2 16 Migration Guide](/guides/react-native/migration-guides/react-native-2-16-migration-guide.md)
- [React Native 2 2 Migration Guide](/guides/react-native/migration-guides/react-native-2-2-migration-guide.md)
- [React Native 2 3 Migration Guide](/guides/react-native/migration-guides/react-native-2-3-migration-guide.md)
- [React Native 2 9 Migration Guide](/guides/react-native/migration-guides/react-native-2-9-migration-guide.md)
- [React Native 2 8 Migration Guide](/guides/react-native/migration-guides/react-native-2-8-migration-guide.md)
- [How to upgrade to the latest React Native version](/guides/react-native/migration-guides/upgrading.md)
- [React Native 4 Migration Guide](/guides/react-native/migration-guides/react-native-4-migration-guide.md)