When implementing Persona’s Embedded Flow within a WebView, there are several important considerations and configuration requirements to ensure optimal performance and functionality.
We strongly recommend using our native mobile SDKs (Android, iOS) instead of WebView where possible. WebView integrations are more difficult to support due to performance constraints of WebView technology.
For more information, see Native mobile integration vs. WebView.
When implementing Embedded Flow in a WebView, you must include the is-webview=true parameter in your URL. This parameter activates the WebView flow and ensures proper functionality.
Your URL should look like:
Please ensure allowsInlineMediaPlayback is enabled when creating a webview on a webkit browser (mobile Safari). This defaults to false and the camera preview will incorrectly open as a fullscreen live broadcast.
The WebView Flow requires access to the device camera. Please include the NSCameraUsageDescription key your app’s Info.plist file as described in the Apple Developer documentation.
Persona makes external network calls within the Inquiry Flow that need to be allowlisted for the flow to properly function. Certain frameworks such as Cordova require such requests to be allow listed. Please include *.withpersona.com/* in such an allow list if needed.
Custom user agents can be parsed incorrectly and cause the flow to behave incorrectly or incorrectly trigger device or browser version specific behavior. We recommend using the default user agent provided by your WebView implementation.
For detailed implementation examples and code snippets, see our legacy WebView documentation: