Skip to main content

How to differentiate between platforms on the Releases page

Issue

On the Releases page, my Android and iOS builds share the same version and the same Sentry project, so I cannot tell which release is which. This is common with React Native and other cross-platform mobile apps.

Applies To

  • All SaaS Customers and Self-Hosted Users

  • Releases

  • React Native / Mobile

Resolution

The Releases page does not show Android vs iOS as a built-in platform label. Differentiate platforms by giving each platform a distinct release package and/or dist value, or by using separate Sentry projects.

Option 1: Put the platform in dist (recommended for React Native)

Use the same app version in release, and a unique dist per platform. Include the platform name in dist.

Example:

// Android build
Sentry.init({
release: "[email protected]",
dist: "android-52",
});

// iOS build
Sentry.init({
release: "[email protected]",
dist: "ios-52",
});

This also keeps Android and iOS bundles and source maps associated correctly. See the React Native troubleshooting documentation.

Option 2: Use distinct package names in the release ID

Name releases as package@version or package@version+build. Use a different package identifier per platform, for example the Android packageName and the iOS CFBundleIdentifier.

Examples:

Then search and filter with release properties such as release.package, release.version, and release.build. See Naming Releases and the Release Properties documentation.

Option 3: Use separate Sentry projects

Create one Sentry project for Android and another for iOS. Point each build at its own DSN. Releases then appear under the matching project, so the Releases page no longer mixes the two platforms in one project list.

Whatever release and dist values you choose, use the same values in the SDK and in your artifact uploads so events, source maps, and release health stay aligned.

Did this answer your question?