Running Relay in a native app
Relay runs inside native iOS and Android apps through the Persona mobile SDKs. If you already ship a Persona SDK for Inquiries, you use the same SDK with a different entry point.
| Platform | Minimum SDK version |
|---|---|
| iOS | 3.5.0 |
| Android | 2.47.0 |
Relay is supported on native iOS and Android. For web, use the Embedded Widget or Hosted Flow.
Relay mode is a separate entry point
The mobile SDKs treat Relay as its own mode. You start it from the Relay session access token your server created, and you do not combine it with a template or inquiry ID. Mixing the two is the most common mistake in a first mobile integration.
Relay mode also deliberately sends less about your app than a normal Inquiry does, for the same reason Hosted Flow refuses a referrer:
- On iOS, the SDK omits information that identifies the host app, such as the bundle identifier.
- On Android, the SDK omits the package name and skips Play Integrity app attestation.
Each of those would be a signal that could associate a verification with your platform, which is what Relay is built to avoid.
Theming on mobile
The light, dark, and auto theme setting applies to the web experiences. It is not currently documented for the iOS or Android SDKs, so treat mobile theming as an open question for your Persona team rather than something you can configure the same way.
Try it
The public demo at explore.withpersona.com/relay runs the web experience, so it is still the fastest way to see the end-to-end flow and the sequence of calls your backend will make, even if you are building for mobile.
Full technical documentation
The developer documentation is the source of truth for the integration:
Plans Explained
Relay on iOS and Android by plan
| Startup Program | Essential Plan | Growth Plan | Enterprise Plan | |
|---|---|---|---|---|
| Relay on iOS and Android | Available | Available | Available | Available |