diff --git a/docs/platforms/apple/common/user-feedback/configuration/index.mdx b/docs/platforms/apple/common/user-feedback/configuration/index.mdx
index cd5d256f59a19c..b0e88639b2c6e1 100644
--- a/docs/platforms/apple/common/user-feedback/configuration/index.mdx
+++ b/docs/platforms/apple/common/user-feedback/configuration/index.mdx
@@ -57,7 +57,7 @@ The following options can be configured for the integration in `SentryUserFeedba
 | Option           | Type                      | Default                     | Description                                                                                                                                                                                                                              |
 | ---------------- | ------------------------- | --------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
 | `location`       | `[NSDirectionalRectEdge]` | `[.bottom, .trailing]`      | The location of the widget on the screen.                                                                                                                                                                                                |
-| `autoInject`     | `Bool`                    | `true`                      | Injects the Feedback widget into the application when the integration is added. Set `autoInject: false` if you want to call `feedback.attachTo()` or `feedback.openDialog()` directly, or only want to show the widget on certain views. |
+| `autoInject`     | `Bool`                    | `true`                      | Injects the Feedback widget into the application when the integration is added. Set `autoInject: false` if you want to call `SentrySDK.feedback.showWidget()` directly, e.g. to show the widget on certain views. |
 | `windowLevel`    | `UIWindow.Level`          | `UIWindow.Level.normal + 1` | The window level of the widget.                                                                                                                                                                                                          |
 | `showIcon`       | `Bool`                    | `true`                      | Whether to show the widget icon.                                                                                                                                                                                                         |
 | `labelText`      | `String?`                 | `"Report a Bug"`            | The text of the widget label. If `nil`, then only the icon is shown. It is an error to set both `labelText` to `nil` and `showIcon` to `false`.                                                                                          |
diff --git a/docs/platforms/apple/common/user-feedback/index.mdx b/docs/platforms/apple/common/user-feedback/index.mdx
index 3548f5636bdfbf..1b63de8fc688c6 100644
--- a/docs/platforms/apple/common/user-feedback/index.mdx
+++ b/docs/platforms/apple/common/user-feedback/index.mdx
@@ -45,6 +45,92 @@ To start using the User Feedback widget in your Cocoa application, provide a fee
 
 This setup will insert the widget into your app's view hierarchy. By default, it appears in the bottom trailing corner of the screen, but you can fully customize its appearance and behavior.
 
+#### SwiftUI
+
+SwiftUI apps don’t currently support automatic widget injection when the SDK starts. Several options exist to display the feedback form:
+
+##### Use your own button
+
+Add a `UIButton` to your app, then provide the reference to the feedback configuration in the SDK start options:
+
+```swift
+import Sentry
+import SwiftUI
+import UIKit
+
+@main
+struct SwiftUIApp: App {
+    // a button displayed somewhere in your app
+    public let feedbackButton = {
+        let button = UIButton(type: .custom)
+        button.setTitle("BYOB Feedback", for: .normal)
+        return button
+    }()
+
+    init() {
+        // start the SentrySDK as usual, as early as possible in your app's launch sequence
+        SentrySDK.start { options in
+            options.configureFeedback { config in 
+                config.customButton = feedbackButton
+            }
+            
+            // your other SDK options
+        }
+    }
+}
+```
+
+##### Manually display the widget from a connected `UIWindowSceneDelegate`
+
+You must set up a `UIApplicationDelegateAdaptor`, connect a `UIScene` to your app, and manually call `SentrySDK.feedback.showWidget()`: 
+
+```swift
+import Sentry
+import SwiftUI
+
+@main
+struct SwiftUIApp: App {
+    @UIApplicationDelegateAdaptor private var appDelegate: MyAppDelegate
+
+    init() {
+        // start the SentrySDK as usual, as early as possible in your app's launch sequence
+        SentrySDK.start { options in
+            // configure feedback and any other SDK options
+        }
+    }
+
+    var body: some Scene {
+        WindowGroup {
+            ContentView()
+        }
+    }
+}
+
+class MyAppDelegate: NSObject, UIApplicationDelegate, ObservableObject {
+    func application(_ application: UIApplication, configurationForConnecting connectingSceneSession: UISceneSession, options: UIScene.ConnectionOptions) -> UISceneConfiguration {
+        let configuration = UISceneConfiguration(
+            name: nil,
+            sessionRole: connectingSceneSession.role)
+        if connectingSceneSession.role == .windowApplication {
+            configuration.delegateClass = MySceneDelegate.self
+        }
+        return configuration
+    }
+}
+
+class MySceneDelegate: NSObject, UIWindowSceneDelegate, ObservableObject {
+    var initializedSentry = false
+    func sceneDidBecomeActive(_ scene: UIScene) {
+        guard !initializedSentry else { return }
+        
+        // display the feedback widget 
+        SentrySDK.feedback.showWidget()
+        
+        initializedSentry = true
+    }
+}
+```
+
 ### Session Replay
 
 The User Feedback widget integrates seamlessly with Session Replay. When the widget is opened, the Replay SDK buffers up to 30 seconds of the user's session. If feedback is submitted, this replay is sent along with the feedback, allowing you to view both the feedback and the user's actions leading up to the feedback submission.