From 99c88ec1b0b27c5f8ea993e001a07df2922da6e2 Mon Sep 17 00:00:00 2001
From: Antonis Lilis <antonis.lilis@sentry.io>
Date: Tue, 27 Jan 2026 12:06:27 +0100
Subject: [PATCH 1/3] chore(changelog): Add upgrade notice in the changelog

---
 CHANGELOG.md | 23 +++++++++++++++++++++++
 1 file changed, 23 insertions(+)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 2cf6684a8f..61e16ac013 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -8,6 +8,29 @@
 
 ## Unreleased
 
+### Upgrading from 7.x to 8.0
+
+Version 8 of the Sentry React Native SDK updates the underlying native SDKs (Cocoa v9, CLI v3, Android Gradle Plugin v6) which introduce breaking changes in minimum version requirements and build tooling.
+
+See our [migration docs](https://docs.sentry.io/platforms/react-native/migration/v7-to-v8/) for more information.
+
+### Breaking Changes
+
+#### Minimum Version Requirements
+
+- **iOS/macOS/tvOS**: ([#5356](https://github.com/getsentry/sentry-react-native/pull/5356))
+  - iOS **15.1+** (previously 13.0+)
+  - macOS **12.0+** (previously 10.13+)
+  - tvOS **15.0+** (previously 13.0+)
+
+- **Android**: ([#5578](https://github.com/getsentry/sentry-react-native/pull/5578))
+  - Sentry Android Gradle Plugin **6.0.0** (previously 5.x)
+  - Android Gradle Plugin **7.4.0+** (previously 7.3.0+)
+  - Kotlin **1.8+**
+
+- **Sentry Self-Hosted**: ([#5523](https://github.com/getsentry/sentry-react-native/pull/5523))
+  - Sentry CLI v3 requires self-hosted **25.11.1+** (previously 25.2.0)
+
 ### Dependencies
 
 - Bump Cocoa SDK from v8.58.0 to v9.1.0 ([#5356](https://github.com/getsentry/sentry-react-native/pull/5356))

From ea9b0595fa9b9bccba3aa4a56cbfcb6090d8b93c Mon Sep 17 00:00:00 2001
From: Antonis Lilis <antonis.lilis@sentry.io>
Date: Thu, 29 Jan 2026 11:04:53 +0100
Subject: [PATCH 2/3] Update versions

---
 CHANGELOG.md | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 7e9d7155ad..694268cfbd 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -19,9 +19,9 @@ See our [migration docs](https://docs.sentry.io/platforms/react-native/migration
 #### Minimum Version Requirements
 
 - **iOS/macOS/tvOS**: ([#5356](https://github.com/getsentry/sentry-react-native/pull/5356))
-  - iOS **15.1+** (previously 13.0+)
-  - macOS **12.0+** (previously 10.13+)
-  - tvOS **15.0+** (previously 13.0+)
+  - iOS **15.0+** (previously 11.0+)
+  - macOS **10.14+** (previously 10.13+)
+  - tvOS **15.0+** (previously 11.0+)
 
 - **Android**: ([#5578](https://github.com/getsentry/sentry-react-native/pull/5578))
   - Sentry Android Gradle Plugin **6.0.0** (previously 5.x)

From 64a65baf98d12523080fac0e333cb9c075977ae7 Mon Sep 17 00:00:00 2001
From: Antonis Lilis <antonis.lilis@sentry.io>
Date: Thu, 29 Jan 2026 13:51:48 +0100
Subject: [PATCH 3/3] Also bump header notice

---
 CHANGELOG.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 694268cfbd..5c96d69774 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -2,7 +2,7 @@
 
 <!-- prettier-ignore-start -->
 > [!IMPORTANT]
-> If you are upgrading to the `7.x` versions of the Sentry React Native SDK from `6.x` or below,
+> If you are upgrading to the `8.x` versions of the Sentry React Native SDK from `7.x` or below,
 > make sure you follow our [migration guide](https://docs.sentry.io/platforms/react-native/migration/) first.
 <!-- prettier-ignore-end -->