# Mobile SDK versioning and support policy

Learn about the Mobile SDK versioning and support policy.

This page describes Stripe’s mobile SDK versioning policy, compatibility with Stripe API versions, and how to update to newer SDK versions.

#### iOS

The [iOS SDK](https://github.com/stripe/stripe-ios) is open source and fully documented.

Stripe’s iOS SDK follows [semantic versioning](https://semver.org/) (semver). This means that version numbers are structured as MAJOR.MINOR.PATCH, where:

- **MAJOR** version increments indicate incompatible API changes
- **MINOR** version increments add functionality in a backwards-compatible manner
- **PATCH** version increments include backwards-compatible bug fixes

We recommend staying up to date with the latest SDK versions to take advantage of new features, improvements, and bug fixes.

## Migration guides and changelog

- [Migration guides](https://github.com/stripe/stripe-ios/blob/master/MIGRATING.md) - Detailed guides for upgrading between major versions
- [Changelog](https://github.com/stripe/stripe-ios/blob/master/CHANGELOG.md): Complete history of changes across all versions

## Support policy

New features and bug fixes are released on the latest major version of the SDK. If you’re on an older major version, we recommend upgrading to the latest major version to take advantage of these features and bug fixes. Older major versions of the SDK continue to be available for use, but won’t receive any additional updates.

#### Android

The [Android SDK](https://github.com/stripe/stripe-android) is open source and fully documented.

Stripe’s Android SDK follows [semantic versioning](https://semver.org/) (semver). This means that version numbers are structured as MAJOR.MINOR.PATCH, where:

- **MAJOR** version increments indicate incompatible API changes
- **MINOR** version increments add functionality in a backwards-compatible manner
- **PATCH** version increments include backwards-compatible bug fixes

We recommend staying up to date with the latest SDK versions to take advantage of new features, improvements, and bug fixes.

## Migration guides and changelog

- [Migration guides](https://github.com/stripe/stripe-android/blob/master/MIGRATING.md) - Detailed guides for upgrading between major versions
- [Changelog](https://github.com/stripe/stripe-android/blob/master/CHANGELOG.md) - Complete history of changes across all versions

## Support policy

New features and bug fixes are released on the latest major version of the SDK. If you’re on an older major version, we recommend upgrading to the latest major version to take advantage of these features and bug fixes. Older major versions of the SDK continue to be available for use, but won’t receive any additional updates.

#### React Native

The [React Native SDK](https://github.com/stripe/stripe-react-native) is open source and fully documented.

Stripe’s React Native SDK follow the 0.x.y versioning schema:

- Breaking changes are shipped in a new minor version where we increment the `x` number (for example: 0.55.0 to 0.56.0).
- New features and APIs are also shipped in a new minor version where we increment the `x` number (for example: 0.55.0 to 0.56.0).
- Critical bug fixes will be shipped in a new patch version where we increment the `y` number (for example: 0.56.0 to 0.56.1).

This is the same versioning policy as [React Native](https://reactnative.dev/docs/next/releases/versioning-policy).

We recommend staying up to date with the latest SDK versions to take advantage of new features, improvements, and bug fixes.

## Changelog

The [Changelog](https://github.com/stripe/stripe-react-native/blob/master/CHANGELOG.md) is a complete history of changes across all versions, including migration information for major version upgrades

## Support policy

New features and bug fixes are released on the latest minor version of the SDK. If you’re on an older minor version, we recommend upgrading to the latest minor version to take advantage of these features and bug fixes. Older minor versions of the SDK continue to be available for use, but won’t receive any additional updates.

## Compatibility with Stripe API versions on your backend

Unless specifically noted in an SDK API, the mobile SDKs is compatible with any Stripe API version you use on your backend.

## See also

- [Stripe versioning and support policy](https://docs.stripe.com/sdks/versioning.md)
- [Stripe.js versioning and support policy](https://docs.stripe.com/sdks/stripejs-versioning.md)