diff --git a/docs/platforms/javascript/guides/bun/migration/v6-to-v7.mdx b/docs/platforms/javascript/guides/bun/migration/v6-to-v7.mdx
new file mode 100644
index 0000000000000..211ecd5cc9532
--- /dev/null
+++ b/docs/platforms/javascript/guides/bun/migration/v6-to-v7.mdx
@@ -0,0 +1,19 @@
+---
+title: Migrate from 6.x to 7.x
+sidebar_order: 8920
+description: "Learn about migrating from Sentry Bun SDK 6.x to 7.x"
+---
+
+The v7 version of the JavaScript SDK (which includes the Bun SDK) requires a self-hosted version of Sentry `20.6.0` or higher.
+
+The main goal of version 7 is to reduce bundle size. This version is breaking because we removed deprecated APIs, upgraded our build tooling, and restructured npm package contents.
+
+**TL;DR** Here's what changed for you:
+
+- If you installed additional Sentry packages alongside your Sentry SDK (e.g. `@sentry/tracing`), make sure to upgrade all of them to version 7.
+- We bumped the TypeScript version we generate our types with to `3.8.3`. Please check if your TypeScript projects using TypeScript version `3.7` or lower still compile. Otherwise, upgrade your TypeScript version.
+- `whitelistUrls` and `blacklistUrls` have been renamed to `allowUrls` and `denyUrls` in the `Sentry.init()` options.
+- The `UserAgent` integration is now called `HttpContext`.
+- If you are using Tracing and with tracing enabled, you might have to make adjustments to your server's CORS settings.
+
+Please see our [detailed migration guide](https://github.com/getsentry/sentry-javascript/blob/develop/docs/migration/v6-to-v7.md) for more information on migrating from `6.x` to `7.x`.
\ No newline at end of file