diff --git a/guides/third-party-analytics.mdx b/guides/third-party-analytics.mdx
index a6805cc..8a72877 100644
--- a/guides/third-party-analytics.mdx
+++ b/guides/third-party-analytics.mdx
@@ -85,7 +85,7 @@ You can also track events from the SDK via the PaywallDelegate or lifecycle meth
     ```swift
     // ... rest of your delegate setup ...
     
-    func onHeliumPaywallEvent(_ event: any HeliumEvent) {
+    func onPaywallEvent(_ event: HeliumEvent) {
         if let paywallOpen = event as? PaywallOpenEvent {
             // e.g., forwarding to mixpanel
             Mixpanel.mainInstance().track(
diff --git a/sdk-reference/migration-2-to-3.mdx b/sdk-reference/migration-2-to-3.mdx
index e4868e2..6f29e67 100644
--- a/sdk-reference/migration-2-to-3.mdx
+++ b/sdk-reference/migration-2-to-3.mdx
@@ -263,9 +263,14 @@ The event system now uses protocol-based events with better type safety and IDE
 
 #### Before v3
 
-`onHeliumPaywallEvent(event:)` (deprecated but still works)
+`onHeliumPaywallEvent(event:)` (removed)
+
+<Warning>
+The `onHeliumPaywallEvent(event:)` method has been removed from the iOS SDK. You must migrate to `onPaywallEvent(_:)`.
+</Warning>
 
 ```swift
+// ❌ No longer available
 func onHeliumPaywallEvent(event: HeliumPaywallEvent) {
     switch event {
     case .paywallOpen(let trigger, let paywallTemplateName, _):
@@ -332,7 +337,7 @@ Helium.shared.initialize(
 
 ## Custom Paywall Traits
 
-You can now pass custom paywall traits when displaying a paywall, replacing the deprecated `HeliumPaywallDelegate.getCustomVariableValues` method.
+Pass custom paywall traits when displaying a paywall. The `HeliumPaywallDelegate.getCustomVariableValues` method has been removed from the iOS SDK.
 
 ```swift
 Helium.shared.presentUpsell(