diff --git a/platform-includes/capture-error/apple.mdx b/platform-includes/capture-error/apple.mdx
index 460bd3dc786d8..fa5eba77b6732 100644
--- a/platform-includes/capture-error/apple.mdx
+++ b/platform-includes/capture-error/apple.mdx
@@ -97,6 +97,12 @@ do {
 
 ## Capturing Uncaught Exceptions
 
+<Note>
+
+The SDK can't install the uncaught exception handler if a debugger is attached. To test these locally, ensure you've unchecked the "Debug executable" option in your app's Xcode scheme's Run action.
+
+</Note>
+
 By default, macOS applications do not crash whenever an uncaught exception occurs. To enable this with Sentry:
 
 1. Open the application's `Info.plist` file
@@ -119,4 +125,6 @@ func applicationDidFinishLaunching(_ aNotification: Notification) {
 }
 ```
 
+Once you have configured your application to crash whenever an uncaught exception occurs, the Apple SDK will capture those automatically. You don't need to manually call `captureException`.
+
 </PlatformSection>