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
 notSupported:
   - javascript.deno
   - javascript.cordova

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/angular/manual-setup.mdx b/docs/platforms/javascript/guides/angular/manual-setup.mdx
@@ -21,20 +21,6 @@ You need:
 
 ## Step 1: Install
 
-Choose the features you want to configure, and this guide will show you how:
-
-<OnboardingOptionButtons
-  options={[
-    "error-monitoring",
-    "performance",
-    "session-replay",
-    "user-feedback",
-    "logs",
-  ]}
-/>
-
-<PlatformContent includePath="getting-started-features-expandable" />
-
 ### Install the Sentry SDK
 
 ```bash {tabTitle:npm}
@@ -77,6 +63,20 @@ If you're updating your Sentry SDK to the latest version, check out our [migrati
 
 ## Step 2: Configure
 
+Choose the features you want to configure, and this guide will show you how:
+
+<OnboardingOptionButtons
+  options={[
+    "error-monitoring",
+    "performance",
+    "session-replay",
+    "user-feedback",
+    "logs",
+  ]}
+/>
+
+<PlatformContent includePath="getting-started-features-expandable" />
+
 The main configuration should happen as early as possible in your app's lifecycle. Typically that means in your `main.ts` file.
 In addition, you'll need to register some providers to fully instrument your application.
 

diff --git a/docs/platforms/javascript/guides/astro/index.mdx b/docs/platforms/javascript/guides/astro/index.mdx
@@ -26,17 +26,6 @@ Before we get started, make sure you have the following:
 
 ## Install
 
-<OnboardingOptionButtons
-  options={[
-    "error-monitoring",
-    "performance",
-    "profiling",
-    "session-replay",
-    "user-feedback",
-    "logs",
-  ]}
-/>
-
 Sentry captures data by using an SDK within your application's runtime.
 
 Install the SDK by using the `astro` CLI:
@@ -75,6 +64,17 @@ To finish the setup, configure the Sentry integration.
 
 ## Configure
 
+<OnboardingOptionButtons
+  options={[
+    "error-monitoring",
+    "performance",
+    "profiling",
+    "session-replay",
+    "user-feedback",
+    "logs",
+  ]}
+/>
+
 To set up the Sentry SDK, register the Sentry integration and initialize the SDK for client and server in the root directory of your project:
 
 ### Astro Integration Setup

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/bun/index.mdx b/docs/platforms/javascript/guides/bun/index.mdx
@@ -12,12 +12,6 @@ categories:
 
 ## Install
 
-In addition to capturing errors, you can monitor interactions between multiple services or applications by [enabling tracing](/concepts/key-terms/tracing/).
-
-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", "logs"]} />
-
 Sentry captures data by using an SDK within your application's runtime.
 
 ```bash {tabTitle:Bun}
@@ -26,6 +20,12 @@ bun add @sentry/bun
 
 ## Configure
 
+In addition to capturing errors, you can monitor interactions between multiple services or applications by [enabling tracing](/concepts/key-terms/tracing/).
+
+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", "logs"]} />
+
 Configuration should happen as early as possible in your application's lifecycle.
 
 Sentry should be initialized as early in your app as possible. It is essential that you call `Sentry.init` before you require any other modules in your application—otherwise, auto-instrumentation of these modules will _not_ work.

diff --git a/docs/platforms/javascript/guides/capacitor/index.mdx b/docs/platforms/javascript/guides/capacitor/index.mdx
@@ -8,16 +8,8 @@ categories:
   - mobile
 ---
 
-## Features
-
-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.
-
 ## Install
 
-<OnboardingOptionButtons options={["error-monitoring", "performance", "session-replay", "user-feedback", "logs"]} />
-
 Sentry captures data by using an SDK within your application's runtime.
 
 Install the Sentry Capacitor SDK alongside the corresponding Sentry SDK for the framework you're using:
@@ -97,6 +89,12 @@ Both Frameworks are fully compatible with the current and beta versions of Sentr
 
 ## Configure
 
+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"]} />
+
 Configuration should happen as early as possible in your application's lifecycle.
 
 Then forward the `init` method from the sibling Sentry SDK for the framework you use, such as Angular in this example: