getsentry · codyde · Nov 10, 2025 · Nov 10, 2025 · Nov 10, 2025 · Nov 11, 2025
diff --git a/docs/platforms/javascript/common/best-practices/index.mdx b/docs/platforms/javascript/common/best-practices/index.mdx
@@ -1,7 +1,8 @@
 ---
 title: Special Use Cases
 description: "Learn how to set up Sentry for several specific use cases with these best practice guides."
-sidebar_order: 8000
+sidebar_order: 18
+sidebar_section: configuration
 notSupported:
   - javascript.node
   - javascript.aws-lambda

diff --git a/docs/platforms/javascript/common/apis.mdx → .../javascript/common/configuration/apis.mdx b/docs/platforms/javascript/common/apis.mdx → .../javascript/common/configuration/apis.mdx
@@ -1,8 +1,7 @@
 ---
 title: APIs
 description: "Learn more about APIs of the SDK."
-customCanonicalTag: "/platforms/javascript/apis/"
-sidebar_order: 3
+sidebar_order: 1
 ---
 
 This page shows all available top-level APIs of the SDK. You can use these APIs as the primary way to:

diff --git a/docs/platforms/javascript/common/configuration/index.mdx b/docs/platforms/javascript/common/configuration/index.mdx
@@ -1,7 +1,9 @@
 ---
-title: Configuration
+title: Extended Configuration
+sidebar_title: Extended Configuration
 description: "Learn about additional configuration options for the JavaScript SDKs."
-sidebar_order: 2
+sidebar_order: 13
+sidebar_section: configuration
 ---
 
 <PageGrid />
diff --git a/docs/platforms/javascript/common/crons/index.mdx b/docs/platforms/javascript/common/crons/index.mdx
@@ -2,7 +2,8 @@
 title: Set Up Crons
 sidebar_title: Crons
 description: "Sentry Crons allows you to monitor the uptime and performance of any scheduled, recurring job in your application."
-sidebar_order: 5750
+sidebar_order: 9
+sidebar_section: features
 supported:
   - javascript.nextjs
   - javascript.sveltekit

diff --git a/docs/platforms/javascript/common/data-management/index.mdx b/docs/platforms/javascript/common/data-management/index.mdx
@@ -1,7 +1,8 @@
 ---
 title: Data Management
 description: Learn about different ways to scrub data within your SDK before it gets sent to Sentry.
-sidebar_order: 7
+sidebar_order: 16
+sidebar_section: configuration
 ---
 
 <PageGrid />
diff --git a/docs/platforms/javascript/common/enriching-events/index.mdx b/docs/platforms/javascript/common/enriching-events/index.mdx
@@ -1,7 +1,8 @@
 ---
 title: Enriching Events
 description: Add additional data to your events to make them easier to debug.
-sidebar_order: 5
+sidebar_order: 12
+sidebar_section: configuration
 ---
 
 In addition to the data that the Sentry SDK automatically captures, you can add additional data to events to help you debug them.

diff --git a/docs/platforms/javascript/common/feature-flags/index.mdx b/docs/platforms/javascript/common/feature-flags/index.mdx
@@ -1,7 +1,8 @@
 ---
 title: Set Up Feature Flags
 sidebar_title: Feature Flags
-sidebar_order: 7000
+sidebar_order: 15
+sidebar_section: features
 description: With Feature Flags, Sentry tracks feature flag evaluations in your application, keeps an audit log of feature flag changes, and reports any suspicious updates that may have caused an error.
 ---
 

diff --git a/docs/platforms/javascript/common/logs/index.mdx b/docs/platforms/javascript/common/logs/index.mdx
@@ -2,7 +2,9 @@
 title: Set Up Logs
 sidebar_title: Logs
 description: "Structured logs allow you to send, view and query logs sent from your applications within Sentry."
-sidebar_order: 5755
+sidebar_order: 4
+sidebar_section: features
+new: true
 notSupported:
   - javascript.deno
   - javascript.cordova

diff --git a/docs/platforms/javascript/common/metrics/index.mdx b/docs/platforms/javascript/common/metrics/index.mdx
@@ -2,7 +2,9 @@
 title: Set Up Metrics
 sidebar_title: Metrics
 description: "Metrics allow you to send, view and query counters, gauges and measurements from your Sentry-configured apps to track application health and drill down into related traces, logs, and errors."
-sidebar_order: 5755
+sidebar_order: 7
+sidebar_section: features
+beta: true
 ---
 
 With Sentry Metrics, you can send counters, gauges, distributions, and sets from your applications to Sentry. Once in Sentry, these metrics can be viewed alongside relevant errors, and searched using their individual attributes.

diff --git a/docs/platforms/javascript/common/migration/index.mdx b/docs/platforms/javascript/common/migration/index.mdx
@@ -1,7 +1,8 @@
 ---
 title: Migration Guide
 description: "Migrate from an older version of our Sentry JavaScript SDK."
-sidebar_order: 8100
+sidebar_order: 19
+sidebar_section: configuration
 notSupported:
   - javascript.capacitor
   - javascript.cordova

diff --git a/docs/platforms/javascript/common/opentelemetry/index.mdx b/docs/platforms/javascript/common/opentelemetry/index.mdx
@@ -1,7 +1,8 @@
 ---
 title: OpenTelemetry Support
 description: "Learn how to use OpenTelemetry with Sentry."
-sidebar_order: 7000
+sidebar_order: 14
+sidebar_section: configuration
 supported:
   - javascript.nextjs
   - javascript.node
@@ -25,6 +26,7 @@ supported:
   - javascript.tanstackstart-react
 notSupported:
   - javascript
+beta: true
 ---
 
 The Sentry SDK uses [OpenTelemetry](https://opentelemetry.io/) under the hood. This means that any OpenTelemetry instrumentation that emits spans will automatically be picked up by Sentry without any further configuration.

diff --git a/docs/platforms/javascript/common/profiling/index.mdx b/docs/platforms/javascript/common/profiling/index.mdx
@@ -1,7 +1,8 @@
 ---
 title: Set Up Profiling
 sidebar_title: Profiling
-sidebar_order: 5000
+sidebar_order: 8
+sidebar_section: features
 description: "Collect & view performance insights for JavaScript programs with Sentry's Profiling integrations. Get started with profiling to understand your application's performance."
 notSupported:
   - javascript.bun

diff --git a/...ascript/common/configuration/sampling.mdx → .../platforms/javascript/common/sampling.mdx b/...ascript/common/configuration/sampling.mdx → .../platforms/javascript/common/sampling.mdx
@@ -1,7 +1,8 @@
 ---
 title: Sampling
 description: "Learn how to configure the volume of error and transaction events sent to Sentry."
-sidebar_order: 50
+sidebar_order: 11
+sidebar_section: configuration
 ---
 
 Adding Sentry to your app gives you a great deal of very valuable information about errors and performance you wouldn't otherwise get. And lots of information is good -- as long as it's the right information, at a reasonable volume.

diff --git a/docs/platforms/javascript/common/security-policy-reporting/index.mdx b/docs/platforms/javascript/common/security-policy-reporting/index.mdx
@@ -1,7 +1,8 @@
 ---
 title: Set Up Security Policy Reporting
 sidebar_title: Security Policy Reporting
-sidebar_order: 7500
+sidebar_order: 17
+sidebar_section: configuration
 description: "Learn how Sentry can help manage Content-Security-Policy violations and reports here."
 ---
 

diff --git a/docs/platforms/javascript/common/session-replay/index.mdx b/docs/platforms/javascript/common/session-replay/index.mdx
@@ -1,7 +1,8 @@
 ---
 title: Set Up Session Replay
 sidebar_title: Session Replay
-sidebar_order: 5500
+sidebar_order: 5
+sidebar_section: features
 notSupported:
   - javascript.cordova
   - javascript.wasm

diff --git a/docs/platforms/javascript/common/sourcemaps/index.mdx b/docs/platforms/javascript/common/sourcemaps/index.mdx
@@ -1,6 +1,7 @@
 ---
 title: Source Maps
 sidebar_order: 3
+sidebar_section: features
 description: "Upload your source maps to Sentry to enable readable stack traces in your errors."
 ---
 

diff --git a/docs/platforms/javascript/common/tracing/index.mdx b/docs/platforms/javascript/common/tracing/index.mdx
@@ -2,7 +2,8 @@
 title: Set Up Tracing
 sidebar_title: Tracing
 description: "Learn how to enable tracing in your app."
-sidebar_order: 4000
+sidebar_order: 6
+sidebar_section: features
 ---
 
 With [tracing](/product/insights/overview/), Sentry automatically tracks your software performance across your application services, measuring metrics like throughput and latency, and displaying the impact of errors across multiple systems.

diff --git a/docs/platforms/javascript/common/troubleshooting/index.mdx b/docs/platforms/javascript/common/troubleshooting/index.mdx
@@ -3,6 +3,7 @@ title: Troubleshooting
 description: >-
   If you need help solving issues with your Sentry JavaScript SDK integration,
   you can read the edge cases documented below.
+sidebar_section: configuration
 keywords:
   - adblocker
   - blocked
@@ -11,7 +12,7 @@ keywords:
   - "404"
 notSupported:
   - javascript.capacitor
-sidebar_order: 9000
+sidebar_order: 20
 og_image: /og-images/platforms-javascript-common-troubleshooting.png
 ---
 

diff --git a/docs/platforms/javascript/common/usage/index.mdx b/docs/platforms/javascript/common/usage/index.mdx
@@ -1,7 +1,8 @@
 ---
-title: Capturing Errors and Events
+title: Capturing Errors
 description: "Learn how to use the SDK to manually capture errors and other events."
-sidebar_order: 4
+sidebar_order: 2
+sidebar_section: features
 ---
 
 Sentry's SDK hooks into your runtime environment and automatically reports errors, uncaught exceptions, and unhandled rejections as well as other types of errors depending on the platform.

diff --git a/docs/platforms/javascript/common/user-feedback/index.mdx b/docs/platforms/javascript/common/user-feedback/index.mdx
@@ -2,7 +2,8 @@
 title: Set Up User Feedback
 sidebar_title: User Feedback
 description: Learn how to enable User Feedback in your app.
-sidebar_order: 6000
+sidebar_order: 10
+sidebar_section: features
 og_image: /og-images/platforms-javascript-common-user-feedback.png
 ---
 

diff --git a/docs/platforms/javascript/guides/astro/profiling/index.mdx b/docs/platforms/javascript/guides/astro/profiling/index.mdx
@@ -1,8 +1,9 @@
 ---
 title: Set Up Profiling
 sidebar_title: Profiling
-sidebar_order: 5000
+sidebar_order: 8
 description: "Collect & view performance insights for JavaScript programs with Sentry's Profiling integrations."
+sidebar_section: features
 ---
 
 <PageGrid />
diff --git a/docs/platforms/javascript/guides/gatsby/profiling/index.mdx b/docs/platforms/javascript/guides/gatsby/profiling/index.mdx
@@ -1,8 +1,9 @@
 ---
 title: Set Up Profiling
 sidebar_title: Profiling
-sidebar_order: 5000
+sidebar_order: 8
 description: "Collect & view performance insights for JavaScript programs with Sentry's Profiling integrations."
+sidebar_section: features
 ---
 
 <PageGrid />
diff --git a/docs/platforms/javascript/guides/nextjs/index.mdx b/docs/platforms/javascript/guides/nextjs/index.mdx
@@ -13,33 +13,17 @@ categories:
 
 <PlatformContent includePath="getting-started-prerequisites" />
 
-## Features
+<StepComponent>
 
-In addition to capturing errors, you can monitor interactions between multiple services or applications by [enabling tracing](/concepts/key-terms/tracing/). You can also get to the root of an error or performance issue faster, by watching a video-like reproduction of a user session with [session replay](/product/explore/session-replay/web/getting-started/).
-
-Select which Sentry features you'd like to install in addition to Error Monitoring to get the corresponding installation and configuration instructions below.
-
-<OnboardingOptionButtons
-  options={[
-    "error-monitoring",
-    "performance",
-    "session-replay",
-    "user-feedback",
-    "logs",
-  ]}
-/>
+## Install
 
-## Step 1: Install
+<SplitLayout>
+<SplitSection>
+<SplitSectionText>
 
-To install Sentry using the installation wizard, run the following command within your project:
+To install Sentry using the installation wizard, run the command on the right within your project directory.
 
-```bash
-npx @sentry/wizard@latest -i nextjs
-```
-
-The wizard then guides you through the setup process, asking you to enable additional (optional) Sentry features for your application beyond error monitoring.
-
-<PlatformContent includePath="getting-started-features-expandable" />
+The wizard guides you through the setup process, asking you to enable additional (optional) Sentry features for your application beyond error monitoring.
 
 This guide assumes that you enable all features and allow the wizard to create an example page and route. You can add or remove features at any time, but setting them up now will save you the effort of configuring them manually later.
 
@@ -54,12 +38,50 @@ This guide assumes that you enable all features and allow the wizard to create a
 
 </Expandable>
 
-## Step 2: Configure
+</SplitSectionText>
+<SplitSectionCode>
+
+```bash
+npx @sentry/wizard@latest -i nextjs
+```
+
+</SplitSectionCode>
+</SplitSection>
+</SplitLayout>
+
+## Configure
 
 If you prefer to configure Sentry manually, here are the configuration files the wizard would create:
 
+In addition to capturing errors, you can monitor interactions between multiple services or applications by [enabling tracing](/concepts/key-terms/tracing/). You can also get to the root of an error or performance issue faster, by watching a video-like reproduction of a user session with [session replay](/product/explore/session-replay/web/getting-started/).
+
+Select which Sentry features you'd like to install in addition to Error Monitoring to get the corresponding installation and configuration instructions below.
+
+<OnboardingOptionButtons
+  options={[
+    "error-monitoring",
+    "performance",
+    "session-replay",
+    "user-feedback",
+    "logs",
+  ]}
+/>
+
+<PlatformContent includePath="getting-started-features-expandable" />
+
+<SplitLayout>
+<SplitSection>
+<SplitSectionText>
+
 ### Client-Side Configuration
 
+The wizard creates a client configuration file that initializes the Sentry SDK in your browser.
+
+The configuration includes your DSN (Data Source Name), which connects your app to your Sentry project, and enables the features you selected during installation.
+
+</SplitSectionText>
+<SplitSectionCode>
+
 ```javascript {tabTitle:Client} {filename:instrumentation-client.(js|ts)}
 import * as Sentry from "@sentry/nextjs";
 
@@ -111,8 +133,21 @@ export const onRouterTransitionStart = Sentry.captureRouterTransitionStart;
 // ___PRODUCT_OPTION_END___ performance
 ```
 
+</SplitSectionCode>
+</SplitSection>
+
+<SplitSection>
+<SplitSectionText>
+
 ### Server-Side Configuration
 
+The wizard also creates a server configuration file for Node.js and Edge runtimes.
+
+For more advanced configuration options or to set up Sentry manually, check out our [manual setup guide](/platforms/javascript/guides/nextjs/manual-setup/).
+
+</SplitSectionText>
+<SplitSectionCode>
+
 ```javascript {tabTitle:Server} {filename:sentry.server.config.(js|ts)}
 import * as Sentry from "@sentry/nextjs";
 
@@ -139,9 +174,11 @@ Sentry.init({
 });
 ```
 
-For detailed manual setup instructions, see our [manual setup guide](/platforms/javascript/guides/nextjs/manual-setup/).
+</SplitSectionCode>
+</SplitSection>
+</SplitLayout>
 
-## Step 3: Verify Your Setup
+## Verify Your Setup
 
 <Include name="nextjs-turbopack-warning-expandable.mdx" />
 
@@ -188,3 +225,5 @@ Our next recommended steps for you are:
 - [Get support](https://sentry.zendesk.com/hc/en-us/)
 
 </Expandable>
+
+</StepComponent>
diff --git a/docs/platforms/javascript/guides/nextjs/profiling/index.mdx b/docs/platforms/javascript/guides/nextjs/profiling/index.mdx
@@ -1,7 +1,8 @@
 ---
 title: Set Up Profiling
 sidebar_title: Profiling
-sidebar_order: 5000
+sidebar_order: 8
+sidebar_section: features
 description: "Collect & view performance insights for JavaScript programs with Sentry's Profiling integrations."
 ---
 

diff --git a/docs/platforms/javascript/guides/nuxt/profiling/index.mdx b/docs/platforms/javascript/guides/nuxt/profiling/index.mdx
@@ -1,8 +1,9 @@
 ---
 title: Set Up Profiling
 sidebar_title: Profiling
-sidebar_order: 5000
+sidebar_order: 8
 description: "Collect & view performance insights for JavaScript programs with Sentry's Profiling integrations."
+sidebar_section: features
 ---
 
 <PageGrid />