Add browser SDK setup options to Cdocs browser partial by rtrieu · Pull Request #37270 · DataDog/documentation

rtrieu · 2026-06-04T18:47:27Z

What does this PR do? What is the motivation?

Fixes DOCS-14485

Restructures the Browser SDK setup page into three collapsible options with guided steps (manual client-side, Agentic Onboarding, and server-side auto-instrumentation), so users only see instructions relevant to their workflow
Adds a comparison table for the three setup methods, so users can quickly choose the right one
Adds a note that server-side auto-instrumentation only supports RUM, so users aren't surprised by missing Session Replay or Product Analytics support
Fixes stepper heading levels in the Browser, Unity, Flutter, and Kotlin Multiplatform setup guides so step titles don't clutter the page Table of Contents

Best to preview this page: https://docs-staging.datadoghq.com/rtrieu/add-browser-setup-options/client_sdks/setup/?platform=browser

Merge instructions

Merge readiness:

Ready for merge

Additional notes

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

…age" This reverts commit 1f1d825.

rtrieu · 2026-06-04T18:49:41Z

Closing — change was accidentally committed to the wrong branch. New PR incoming.

github-actions · 2026-06-04T19:02:20Z

Preview links (active after the `build_preview` check completes)

New or renamed files

https://docs-staging.datadoghq.com/rtrieu/add-browser-setup-options/real_user_monitoring/application_monitoring/browser/setup/

Modified Files

https://docs-staging.datadoghq.com/rtrieu/add-browser-setup-options/real_user_monitoring/application_monitoring/browser/setup/

…setup-options

rtrieu · 2026-06-05T20:00:31Z

⚠️ Possible site support note detected

The following files have a site-region shortcode at the top of the page that mentions a feature being "not available" or "not supported":

content/en/real_user_monitoring/application_monitoring/browser/setup/_index.md

Are you trying to document site support for a product? If so, the site-region shortcode is not the recommended approach. See the Documenting site support guide for the preferred method.

@github-actions this can be ignored because it's for the specific instrumentation option

urseberry

Thanks for the detailed summary in the PR description to help me understand the scope of the changes!

I did not contact cdocs-reviewers, so make sure that you also get a review from someone in that group.

urseberry · 2026-06-05T21:34:21Z

This file needs to be removed from the repository and from this PR, since it will be generated by Cdocs going forward. Similarly, you need to add an entry for it to the .gitignore. For an example, see #36102

urseberry · 2026-06-05T21:36:51Z

 [12]: /real_user_monitoring/application_monitoring/browser/setup/server
 [13]: /real_user_monitoring/application_monitoring/agentic_onboarding/?tab=realusermonitoring


Suggested change

[13]: /real_user_monitoring/application_monitoring/agentic_onboarding/?tab=realusermonitoring

The body no longer references links 12 and 13, so you should remove them.

urseberry · 2026-06-05T21:44:05Z

@@ -0,0 +1,11 @@
+#### Limitations
+
+Auto-instrumentation for this server has the following limitations. If your use case requires more control, use [client-side instrumentation][101] instead.


Suggested change

Auto-instrumentation for this server has the following limitations. If your use case requires more control, use [client-side instrumentation][101] instead.

Server-side auto-instrumentation has the following limitations. If your use case requires more control, use [client-side instrumentation][101] instead.

When this partial shows up on the index page (https://docs-staging.datadoghq.com/rtrieu/add-browser-setup-options/client_sdks/setup/), the user hasn't had to select a server, so "this server" doesn't make sense. I suggest rewording it to be more general.

urseberry · 2026-06-05T21:45:25Z

+
+## Overview
+
+The Datadog Browser SDK enables Real User Monitoring (RUM) for your web applications, providing comprehensive visibility into user experience and application performance. With RUM, you can monitor page load times, user interactions, resource loading, and application errors in real-time.


Suggested change

The Datadog Browser SDK enables Real User Monitoring (RUM) for your web applications, providing comprehensive visibility into user experience and application performance. With RUM, you can monitor page load times, user interactions, resource loading, and application errors in real-time.

The Datadog Browser SDK enables Real User Monitoring (RUM) for your web applications, providing visibility into user experience and application performance. With RUM, you can monitor page load times, user interactions, resource loading, and application errors in real time.

urseberry · 2026-06-05T21:45:44Z

+There are three ways to instrument your browser-based web applications with the Browser SDK:
+
+- [**Manual client-side setup**][1]: Instrument your browser-based web applications, deploy them, configure the initialization parameters you want to track, and use advanced configuration to further manage the data and context that RUM collects.
+- [**Agentic Onboarding**][2]: Instrument your frontend applications with one prompt using LLM coding agents like Cursor or Claude.


Suggested change

- [**Agentic Onboarding**][2]: Instrument your frontend applications with one prompt using LLM coding agents like Cursor or Claude.

- [**Agentic Onboarding**][2]: Instrument your frontend applications with one prompt using LLM coding agents such as Cursor or Claude.

urseberry · 2026-06-05T21:46:11Z

+| **SDK setup mechanism** | Manually add the RUM SDK to your application code and manage configurations in code. | Use an AI-guided setup that detects your project's framework and adds the RUM SDK with a single prompt. | Automatically add RUM JS to your web app HTML, then manage configurations in the UI. |
+| **Code changes required** | Yes | Yes (automated by AI agent) | No |
+| **Setup complexity** | Medium | Low | Low |
+| **Supported platforms** | All browser-based applications | Next.js, React, Svelte, Vue, Vanilla JavaScript | Apache, IBM HTTP Server, Java Servlet, Nginx, Windows IIS |


rtrieu and others added 5 commits May 29, 2026 15:27

first push testing

93e74fe

turn agentic onboarding into a partial and create setup page mdoc

546e855

Merge branch 'master' into rtrieu/add-browser-setup-options

011b960

add descr

699ad15

[DOCS-14485] Add GovCloud unavailability banner to Heatmaps page

1f1d825

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

rtrieu requested review from a team as code owners June 4, 2026 18:47

github-actions Bot added Architecture Everything related to the Doc backend cdocs labels Jun 4, 2026

rtrieu added the WORK IN PROGRESS No review needed, it's a wip ;) label Jun 4, 2026

Revert "[DOCS-14485] Add GovCloud unavailability banner to Heatmaps p…

f350276

…age" This reverts commit 1f1d825.

rtrieu closed this Jun 4, 2026

rtrieu reopened this Jun 4, 2026

rtrieu changed the title ~~[DOCS-14485] Add GovCloud unavailability banner to Heatmaps page~~ Add browser SDK setup options to Cdocs browser partial Jun 4, 2026

rtrieu added 5 commits June 5, 2026 11:16

add steppers

3893d1e

Merge remote-tracking branch 'origin/master' into rtrieu/add-browser-…

5766ef3

…setup-options

delete unnecessary stuff

b568926

change table type

1b11254

add stepper header level to a few more sdks

acbc167

rtrieu removed the WORK IN PROGRESS No review needed, it's a wip ;) label Jun 5, 2026

rtrieu added the WORK IN PROGRESS No review needed, it's a wip ;) label Jun 5, 2026

rtrieu added 2 commits June 5, 2026 13:20

update

7183e4e

make options collapsible

7f65ae8

rtrieu removed the WORK IN PROGRESS No review needed, it's a wip ;) label Jun 5, 2026

add a next step

eb57e84

urseberry self-assigned this Jun 5, 2026

urseberry requested changes Jun 5, 2026

View reviewed changes

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Add browser SDK setup options to Cdocs browser partial#37270

Add browser SDK setup options to Cdocs browser partial#37270
rtrieu wants to merge 14 commits into
masterfrom
rtrieu/add-browser-setup-options

rtrieu commented Jun 4, 2026 •

edited

Loading

Uh oh!

rtrieu commented Jun 4, 2026

Uh oh!

github-actions Bot commented Jun 4, 2026 •

edited

Loading

Uh oh!

rtrieu commented Jun 5, 2026

⚠️ Possible site support note detected

Uh oh!

urseberry left a comment

Uh oh!

urseberry Jun 5, 2026

Uh oh!

urseberry Jun 5, 2026

Uh oh!

urseberry Jun 5, 2026

Uh oh!

urseberry Jun 5, 2026

Uh oh!

urseberry Jun 5, 2026

Uh oh!

urseberry Jun 5, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

		[12]: /real_user_monitoring/application_monitoring/browser/setup/server
		[13]: /real_user_monitoring/application_monitoring/agentic_onboarding/?tab=realusermonitoring

		@@ -0,0 +1,11 @@
		#### Limitations

		Auto-instrumentation for this server has the following limitations. If your use case requires more control, use [client-side instrumentation][101] instead.

	Auto-instrumentation for this server has the following limitations. If your use case requires more control, use [client-side instrumentation][101] instead.
	Server-side auto-instrumentation has the following limitations. If your use case requires more control, use [client-side instrumentation][101] instead.


		## Overview

		The Datadog Browser SDK enables Real User Monitoring (RUM) for your web applications, providing comprehensive visibility into user experience and application performance. With RUM, you can monitor page load times, user interactions, resource loading, and application errors in real-time.

	- [Agentic Onboarding][2]: Instrument your frontend applications with one prompt using LLM coding agents like Cursor or Claude.
	- [Agentic Onboarding][2]: Instrument your frontend applications with one prompt using LLM coding agents such as Cursor or Claude.

	\| Supported platforms \| All browser-based applications \| Next.js, React, Svelte, Vue, Vanilla JavaScript \| Apache, IBM HTTP Server, Java Servlet, Nginx, Windows IIS \|
	\| Supported platforms \| All browser-based applications \| Next.js, React, Svelte, Vue, Vanilla JavaScript \| Apache, IBM HTTP Server, Java Servlet, NGINX, Windows IIS \|

Conversation

rtrieu commented Jun 4, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

What does this PR do? What is the motivation?

Merge instructions

Additional notes

Uh oh!

rtrieu commented Jun 4, 2026

Uh oh!

github-actions Bot commented Jun 4, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Preview links (active after the build_preview check completes)

New or renamed files

Modified Files

Uh oh!

rtrieu commented Jun 5, 2026

⚠️ Possible site support note detected

Uh oh!

urseberry left a comment

Choose a reason for hiding this comment

Uh oh!

urseberry Jun 5, 2026

Choose a reason for hiding this comment

Uh oh!

urseberry Jun 5, 2026

Choose a reason for hiding this comment

Uh oh!

urseberry Jun 5, 2026

Choose a reason for hiding this comment

Uh oh!

urseberry Jun 5, 2026

Choose a reason for hiding this comment

Uh oh!

urseberry Jun 5, 2026

Choose a reason for hiding this comment

Uh oh!

urseberry Jun 5, 2026

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

rtrieu commented Jun 4, 2026 •

edited

Loading

github-actions Bot commented Jun 4, 2026 •

edited

Loading

Preview links (active after the `build_preview` check completes)