diff --git a/content/docs/ios/guides/advanced/request-permissions-from-paywalls.mdx b/content/docs/ios/guides/advanced/request-permissions-from-paywalls.mdx
index dfa2644..9830aef 100644
--- a/content/docs/ios/guides/advanced/request-permissions-from-paywalls.mdx
+++ b/content/docs/ios/guides/advanced/request-permissions-from-paywalls.mdx
@@ -6,6 +6,10 @@ description: "Trigger the iOS system permission dialog directly from a Superwall
## Overview
Use the **Request permission** action in the paywall editor when you want to gate features behind iOS permissions without sending users into your app settings flow. When the user taps the element, SuperwallKit presents the native prompt, reports the result back to the paywall so you can update the design, and emits analytics events you can forward through `SuperwallDelegate`.
+
+The **Request permission** action is rolling out to the paywall editor and is not visible in the dashboard just yet. We're shipping it very soon, so keep an eye on the changelog if you don't see it in your editor today.
+
+
## Add the action in the editor
1. Open your paywall in the editor and select the button or element you want to wire up.
2. Set its action to **Request permission**.
diff --git a/content/docs/ios/sdk-reference/SuperwallEvent.mdx b/content/docs/ios/sdk-reference/SuperwallEvent.mdx
index ffba120..1ffff96 100644
--- a/content/docs/ios/sdk-reference/SuperwallEvent.mdx
+++ b/content/docs/ios/sdk-reference/SuperwallEvent.mdx
@@ -81,6 +81,10 @@ This is an enum that represents different event types. Events are received via [
These events are received via [`SuperwallDelegate.handleSuperwallEvent(withInfo:)`](/ios/sdk-reference/SuperwallDelegate) for forwarding to your analytics platform.
## Permission events (4.12.0+)
+
+The **Request permission** action for the paywall editor is rolling out and isn't visible in the dashboard yet. Editor support is coming very soon, so you may not see the action in your workspace today.
+
+
When you wire the **Request permission** action in the paywall editor, the SDK emits `permission_requested`, `permission_granted`, and `permission_denied` events. Use them to track opt-in funnels or adapt your UI:
```swift