diff --git a/docs/platforms/react-native/configuration/app-hangs.mdx b/docs/platforms/react-native/configuration/app-hangs.mdx index 96eca78b6f027..be30f3e427356 100644 --- a/docs/platforms/react-native/configuration/app-hangs.mdx +++ b/docs/platforms/react-native/configuration/app-hangs.mdx @@ -30,4 +30,19 @@ Sentry.init({ }); ``` +### Pause and Resume App Hang Tracking (iOS only) + +Starting with version 8.13.0, you can pause and resume app hang tracking at runtime. This is useful when showing system dialogs (for example, permission prompts) that block the main thread but aren't real app hangs. + +```javascript +import * as Sentry from "@sentry/react-native"; + +Sentry.pauseAppHangTracking(); + +// Do something that might cause the app to hang, +// and you don't want the SDK to report it. + +Sentry.resumeAppHangTracking(); +``` + To read more about how app hangs are detected, check out the `sentry-cocoa` [documentation](/platforms/apple/configuration/app-hangs/).