Add Unity and platform-specific console documentation for Sentry (#14075)

bruno-garcia · antonpirker · commit 2ac1bb7cd595 · 2025-06-24T14:23:43.000+02:00
diff --git a/docs/platforms/nintendo-switch/index.mdx b/docs/platforms/nintendo-switch/index.mdx
@@ -8,17 +8,10 @@ categories:
   - gaming
 ---
 
-<PlatformContent includePath="getting-started-primer" />
+<Include name="console-intro/nintendo-switch" />
 
-To get started using Sentry in your Nintendo Switch games, you can go to [CRPORTAL](https://crash-report.wc.lp1.er.srv.nintendo.net/sentry/get_started).
-No changes to the game are required, as you can configure Nintendo's servers to start forwarding your crashes to Sentry.
-Support for both devkit as well as retail devices are available.
+You can also use Sentry's [Unity](/platforms/unity/game-consoles/) and [Unreal Engine SDKs](/platforms/unity/game-consoles/) with Nintendo Switch.
 
-If you want to add additional context to your crash dumps or you want to capture non-fatal events, Sentry offers an SDK specifically for Nintendo Switch.
-It allows for adding additional context such as [breadcrumbs](/product/issues/issue-details/breadcrumbs/) and [tags](/product/issues/issue-details/#tags).
-To get access to the SDK, please reach out via the [Nintendo Developer Authorization](https://developer.nintendo.com/group/development/getting-started/g1kr9vj6/middleware/sentry) form. 
-Or via [Sentry Support](https://sentry.zendesk.com/hc/en-us/requests/new).
-
----
+----
 
 "Nintendo", "Nintendo Switch" are trademarks or registered trademarks of Nintendo.
diff --git a/docs/platforms/playstation/index.mdx b/docs/platforms/playstation/index.mdx
@@ -8,14 +8,9 @@ categories:
   - gaming
 ---
 
-<PlatformContent includePath="getting-started-primer" />
+<Include name="console-intro/playstation" />
 
-No changes to the game are required, Sentry will pull crashes and additional data such as screenshots automatically.
-Support for both devkit as well as retail devices are available.
-
-To start using Sentry in your PS5 games, you can head over to the [Sentry page inside PlayStation Partners](https://game.develop.playstation.net/tm/verify/functionalsw) and confirm your developer status by clicking on *Confirm status*.
-
-We'll receive your request and get back to you with the next steps.
+You can also use Sentry's [Unity](/platforms/unity/game-consoles/) and [Unreal Engine SDKs](/platforms/unity/game-consoles/) with PlayStation.
 
 ----
 
diff --git a/docs/platforms/unity/game-consoles/index.mdx b/docs/platforms/unity/game-consoles/index.mdx
@@ -0,0 +1,27 @@
+---
+title: Game Consoles
+description: "Learn how to configure your Unity SDK to capture errors on Xbox, PlayStation and Nintendo Switch."
+sidebar_order: 7
+---
+
+Sentry supports [PlayStation](https://docs.sentry.io/platforms/playstation/), [Xbox](https://docs.sentry.io/platforms/xbox/) and [Nintendo Switch](https://docs.sentry.io/platforms/nintendo-switch/) via the Unity SDK.  Once you submit the middleware verification process, we'll reach out and send you an invite to our private GitHub repositories with console specific code.
+This allows your configuration and custom data set via C# to show up in C# exceptions as well as crash dumps on these console platforms.
+
+
+## Nintendo Switch
+
+<Include name="console-intro/nintendo-switch" />
+
+## Xbox
+
+<Include name="console-intro/xbox" />
+
+## PlayStation
+
+<Include name="console-intro/playstation" />
+
+----
+
+"Nintendo", "Nintendo Switch" are trademarks or registered trademarks of Nintendo.
+"Microsoft", "Xbox" are trademarks of the Microsoft group of companies.
+"PlayStation", "PS5" are registered trademarks or trademarks of Sony Interactive Entertainment Inc.
diff --git a/docs/platforms/unreal/game-consoles/index.mdx b/docs/platforms/unreal/game-consoles/index.mdx
@@ -4,44 +4,24 @@ description: "Learn how to configure your SDK to capture errors on Xbox, PlaySta
 sidebar_order: 7
 ---
 
-Sentry supports [PlayStation](https://docs.sentry.io/platforms/playstation/), [Xbox](https://docs.sentry.io/platforms/xbox/) and [Nintendo Switch](https://docs.sentry.io/platforms/nintendo-switch/) via the Unreal Engine SDK extensions. The access to these is given by sending an invite to private repositories on GitHub after you complete the middleware verification process.
+Sentry supports [PlayStation](https://docs.sentry.io/platforms/playstation/), [Xbox](https://docs.sentry.io/platforms/xbox/) and [Nintendo Switch](https://docs.sentry.io/platforms/nintendo-switch/) via the Unreal Engine SDK extensions. Once you submit the middleware verification process, we'll reach out and send you an invite to our private GitHub repositories with console specific code.
+This allows your configuration and custom data set via C++ or Blueprints to show up in non-fatal events as well as crash dumps on these console platforms.
 
-## Xbox
-
-To start using Sentry Unreal Engine SDK extension in your Xbox games [complete Microsoft Game Development Kit (GDK) Middleware verification process](https://developer.microsoft.com/en-us/games/support/request-gdkx-middleware).
-
-We'll receive your request and get back to you with the next steps.
-
-----
-
-"Microsoft", "Xbox" are trademarks of the Microsoft group of companies.
 
 ## PlayStation
 
-To start using Sentry Unreal Engine SDK extension in your PS5 games head over to the [Sentry page inside PlayStation Partners](https://game.develop.playstation.net/tm/verify/functionalsw) and confirm your developer status by clicking on *Confirm status*.
+<Include name="console-intro/playstation" />
 
-We'll receive your request and get back to you with the next steps.
+## Xbox
 
-<Alert>
+<Include name="console-intro/xbox" />
 
-Crash capturing on PlayStation doesn't require the Unreal Engine SDK, but in order to add tags and other context, you'll need to install it along with the corresponding plugin extension.
+## Nintendo Switch
 
-</Alert>
+<Include name="console-intro/nintendo-switch" />
 
 ----
 
 "PlayStation", "PS5" are registered trademarks or trademarks of Sony Interactive Entertainment Inc.
-
-## Nintendo Switch
-
-To get started using Sentry in your Nintendo Switch games, you can go to [CRPORTAL](https://crash-report.wc.lp1.er.srv.nintendo.net/sentry/get_started).
-No changes to the game are required, as you can configure Nintendo's servers to start forwarding your crashes to Sentry.
-
-If you want to add additional context to your crash dumps or you want to capture non-fatal events, Sentry offers an Unreal Engine SDK extension specifically for Nintendo Switch.
-It allows for adding additional context such as [breadcrumbs](/product/issues/issue-details/breadcrumbs/) and [tags](/product/issues/issue-details/#tags).
-To get access to the corresponding plugin extension, please reach out via the [Nintendo Developer Authorization](https://developer.nintendo.com/group/development/getting-started/g1kr9vj6/middleware/sentry) form. 
-Or via [Sentry Support](https://sentry.zendesk.com/hc/en-us/requests/new).
-
----
-
-"Nintendo", "Nintendo Switch" are trademarks or registered trademarks of Nintendo.
+"Microsoft", "Xbox" are trademarks of the Microsoft group of companies.
+"Nintendo", "Nintendo Switch" are trademarks or registered trademarks of Nintendo.
diff --git a/docs/platforms/xbox/index.mdx b/docs/platforms/xbox/index.mdx
@@ -8,15 +8,10 @@ categories:
   - gaming
 ---
 
-<PlatformContent includePath="getting-started-primer" />
+<Include name="console-intro/xbox" />
 
-Sentry supports Xbox via a customized version of the [Native SDK](/platforms/native).
-Support for both devkit as well as retail devices are available.
+You can also use Sentry's [Unity](/platforms/unity/game-consoles/) and [Unreal Engine SDKs](/platforms/unity/game-consoles/) with Xbox.
 
-To start using Sentry in your Xbox games, you can [request Microsoft Game Development Kit (GDK) Middleware access](https://developer.microsoft.com/en-us/games/support/request-gdkx-middleware).
-
-We'll receive your request and get back to you with the next steps.
-
----
+----
 
 "Microsoft", "Xbox" are trademarks of the Microsoft group of companies.
diff --git a/includes/console-intro/nintendo-switch.mdx b/includes/console-intro/nintendo-switch.mdx
@@ -0,0 +1,11 @@
+You can get started using Sentry on Nintendo Switch without any changes to your game, on devkits as well as retail devices.
+
+It can be done directly on Nintendo's CRPORTAL. The two environments available are [lp1 for retail devices](https://crash-report.wc.lp1.er.srv.nintendo.net/sentry/get_started) 
+and [dd1 for devkits](https://crash-report.wc.dd1.er.srv.nintendo.net/sentry/get_started).
+In both cases you can configure Nintendo's servers to start forwarding your crashes directly to Sentry.
+
+If you want to add additional context to your crash dumps, or you want to capture non-fatal events, Sentry offers an SDK specifically for Nintendo Switch.
+It allows for adding additional context such as [breadcrumbs](/product/issues/issue-details/breadcrumbs/) and [tags](/product/issues/issue-details/#tags).
+To get access to the SDK, please reach out via the [Nintendo Developer Authorization](https://developer.nintendo.com/group/development/getting-started/g1kr9vj6/middleware/sentry) form. 
+
+Support for Switch 2 as well as the original Switch is available.
diff --git a/includes/console-intro/playstation.mdx b/includes/console-intro/playstation.mdx
@@ -0,0 +1,10 @@
+You can get started using Sentry on PlayStation without any changes to your game, on devkits as well as retail devices.
+
+Configuration can be done in your Sentry project settings, on a new page called PlayStation that is made available to you once the middleware verification process is done.
+
+The verification process starts [inside the PlayStation Partners website](https://game.develop.playstation.net/tm/verify/functionalsw) where you can confirm your developer status by clicking on *Confirm status*. 
+We'll receive your request and get back to you with the next steps.
+
+
+Even though crash dump collection doesn't require a Sentry SDK, if you add it, you can get additional context in your crash dumps, as well as capture non-fatal events.
+Sentry offers SDK support specifically for PlayStation so you can add context such as [breadcrumbs](/product/issues/issue-details/breadcrumbs/) and [tags](/product/issues/issue-details/#tags).
diff --git a/includes/console-intro/xbox.mdx b/includes/console-intro/xbox.mdx
@@ -0,0 +1,5 @@
+You can get started using Sentry by [requesting Microsoft Game Development Kit (GDK) Middleware access](https://developer.microsoft.com/en-us/games/support/request-gdkx-middleware).
+We'll receive your request and get back to you with the next steps.
+
+Support is available on Xbox Series X and S, by adding the Sentry SDK to your game. 
+Crash collection as well as non-fatal events can be captured, on devkits as well as retail devices.
