Issue
I set up Release Management through the SDK or the Crash Reporter Client, but my release shows no adoption in the Releases tab.
Applies To
All SaaS Customers and Self-Hosted Users
Release Management
Unreal Engine
Symptoms
On the Releases page, every release you set shows 0% adoption.
A separate release with version
1.0.0.0shows adoption, possibly 100%.
Resolution
This happens because, unless you override it, the Unreal SDK derives the release name automatically from your project name and version as <ProjectName>@<Version>. The project version defaults to 1.0.0.0, so real user sessions attach to that derived release (which is why 1.0.0.0 shows adoption) while the releases you set elsewhere show 0%.
The SDK chooses the release name in this order:
The
Releasevalue in the Sentry plugin settings, if "Override release name" (OverrideReleaseName) is enabled.The
SENTRY_RELEASEenvironment variable.The derived
<ProjectName>@<Version>from your project settings.
To make adoption attribute to the release you expect, do one of the following:
Set the release explicitly (recommended). In the Unreal Editor, go to Edit > Project Settings > Plugins > Sentry, under Release & Health enable "Override release name", and set
Releaseto the release name you use. This takes precedence over the derived value.Set the
SENTRY_RELEASEenvironment variable to your release name before the application runs.Update the derived value by setting your project version in Edit > Project Settings > Project > Description (the About section), so
<ProjectName>@<Version>matches your intended release.
Use the same release name everywhere. The SDK and the Crash Reporter Client must report the same release, otherwise sessions and crashes attribute to different releases and adoption stays at 0%. For more detail, see the Unreal release configuration docs.