diff --git a/CHANGELOG.md b/CHANGELOG.md
index b3a2d3b..36c60cb 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -4,6 +4,14 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [2.3.1] - 2026-06-03
+
+### Fixed
+- Fixed session recordings associating events with the wrong DevRev workspace.
+- [iOS] Fixed crashes from thread-unsafe access.
+- [Android] Fixed masking issues on rapid scrolls.
+- [Android] Fixed an issue with missing crash types.
+
 ## [2.3.0] - 2026-04-28
 
 ### Changed
diff --git a/README.md b/README.md
index cfd2d70..a11a38f 100644
--- a/README.md
+++ b/README.md
@@ -627,10 +627,25 @@ DevRev.processPushNotification(messageJson, function() {
 
 ##### iOS
 
-On iOS devices, you must pass the received push notification payload to the DevRev SDK for processing. The SDK handles the notification and executes the necessary actions.
+On iOS devices, you must update the `AppDelegate` to intercept notification clicks and forward the payload to the SDK.
 
-```javascript
-DevRev.processPushNotification(payload, successCallback, errorCallback)
+In `didFinishLaunchingWithOptions`, set the `UNUserNotificationCenter` delegate:
+
+```swift
+UNUserNotificationCenter.current().delegate = self
+```
+
+Implement `userNotificationCenter(_:didReceive:)` to pass the notification payload to the SDK:
+
+```swift
+func userNotificationCenter(
+    _ center: UNUserNotificationCenter,
+    didReceive response: UNNotificationResponse
+) async {
+    await DevRev.processPushNotification(
+        response.notification.request.content.userInfo
+    )
+}
 ```
 
 For example:
diff --git a/devrev-sdk-cordova-2.3.1.tgz b/devrev-sdk-cordova-2.3.1.tgz
new file mode 100644
index 0000000..97c6e38
Binary files /dev/null and b/devrev-sdk-cordova-2.3.1.tgz differ
diff --git a/sample/package.json b/sample/package.json
index dde73f5..68352f1 100644
--- a/sample/package.json
+++ b/sample/package.json
@@ -1,7 +1,7 @@
 {
   "name": "ai.devrev.sdk.bridge.cordova.sample",
   "displayName": "DevRevSDK (Cordova)",
-  "version": "2.3.0",
+  "version": "2.3.1",
   "description": "DevRev SDK for Cordova sample app.",
   "main": "index.js",
   "scripts": {
@@ -27,7 +27,7 @@
     "platforms": []
   },
   "devDependencies": {
-    "@devrev/sdk-cordova": "2.3.0",
+    "@devrev/sdk-cordova": "2.3.1",
     "cordova-plugin-device": "^3.0.0",
     "cordova-plugin-firebase-messaging": "^8.0.1",
     "cordova-support-android-plugin": "~2.0.4"