> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.withpersona.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.withpersona.com/_mcp/server.

# Troubleshooting common issues

> **Warning**
>
> #### Native SDKs Recommended
>
> 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](/webview-vs-native-mobile-integration).

## Camera capture flows do not show at all or show as fullscreen

When initializing the webview, ensure `allowsInlineMediaPlayback` is set to `true` ([example](/quickstart-ios-wkwebview#example-code)). Note that on some platforms like Cordova, this option may be revealed via a different API.

On some devices like iPads, media playback defaults to fullscreen.

## Camera capture flows are showing a debug view on XCode's simulator

This is expected; the iOS simulator does not allow a real webcam to be used.

## Issues integrating with [`react-native-webview`](https://github.com/react-native-webview/react-native-webview)

We do not support using the WebView integration with React Native. If you want to integrate with a React Native application, please see our [React Native Integration Guide](/docs/react-native-sdk-integration).

## The viewport looks incorrect (incorrect scaling, incorrect centering, etc.)

Ensure that the HTML you are passing to your WebView specifies viewport settings. The exact settings will depend on your integration, but you likely want something resembling:

**`HTML`**

```html HTML
<meta name="viewport" content="width=device-width, initial-scale=1" />
```

See [Viewport meta tag](https://developer.mozilla.org/en-US/docs/Web/HTML/Viewport_meta_tag) for more information.