From 307621f278658483ec6bd822832d81c4a1171d45 Mon Sep 17 00:00:00 2001 From: Nick Trogh Date: Mon, 13 Oct 2025 11:40:53 +0200 Subject: [PATCH 1/4] Add experimentation section --- docs/configure/telemetry.md | 15 +++++++++++---- 1 file changed, 11 insertions(+), 4 deletions(-) diff --git a/docs/configure/telemetry.md b/docs/configure/telemetry.md index a01da4d415..2ce0536d7b 100644 --- a/docs/configure/telemetry.md +++ b/docs/configure/telemetry.md @@ -5,7 +5,9 @@ MetaDescription: Learn about Visual Studio Code collected telemetry and how to o --- # Telemetry -Visual Studio Code collects telemetry data, which is used to help understand how to improve the product. For example, this usage data helps to debug issues, such as slow start-up times, and to prioritize new features. While we appreciate the insights this data provides, we also know that not everyone wants to send usage data and you can disable telemetry as described in [disable telemetry reporting](#disable-telemetry-reporting). You can also read our [privacy statement](https://go.microsoft.com/fwlink/?LinkID=528096&clcid=0x409) to learn more. +Visual Studio Code collects telemetry data, which is used to help understand how to improve the product. For example, this usage data helps to debug issues, such as slow start-up times, and to prioritize new features. We also use this data to [roll out new features](#feature-availability-and-telemetry) to a subset of users before making them generally available. + +While we appreciate the insights this data provides, we also know that not everyone wants to send usage data and you can disable telemetry as described in [disable telemetry reporting](#disable-telemetry-reporting). You can also read our [privacy statement](https://go.microsoft.com/fwlink/?LinkID=528096&clcid=0x409) to learn more. ## Types of telemetry data @@ -19,7 +21,7 @@ VS Code and this page refer to three different types of data with respect to tel ## Disable telemetry reporting -With the `setting(telemetry.telemetryLevel)` user [setting](/docs/configure/settings.md), you can control the different types of telemetry we send with a single setting. Here is a table of the different types of data sent with each value of `setting(telemetry.telemetryLevel)`: +With the `setting(telemetry.telemetryLevel)` user setting, you can control the different types of telemetry we send with a single setting. Here is a table of the different types of data sent with each value of `setting(telemetry.telemetryLevel)`: | | Crash Reports | Error Telemetry | Usage Data | |:------|:---------------------:|:---------------:|:--------------:| @@ -28,7 +30,7 @@ With the `setting(telemetry.telemetryLevel)` user [setting](/docs/configure/sett | crash | ✓ | - | - | | off | - | - | - | -For example, if you don't want to send any telemetry data to Microsoft, you can set the `setting(telemetry.telemetryLevel)` user [setting](/docs/configure/settings.md) to `off`. This will silence all telemetry events from VS Code going forward. Note that telemetry information may have been collected and sent up until the point when you disable the setting. +For example, if you don't want to send any telemetry data to Microsoft, you can set the `setting(telemetry.telemetryLevel)` user setting to `off`. This will silence all telemetry events from VS Code going forward. Note that telemetry information may have been collected and sent up until the point when you disable the setting. ![disable telemetry](images/telemetry/disable-telemetry.png) @@ -38,6 +40,12 @@ If you use the JSON editor for your settings, add the following line: "telemetry.telemetryLevel": "off" ``` +## Feature availability and telemetry + +VS Code uses an A/B experimentation system to roll out new features to a subset of users before making them generally available. This helps us validate that a new feature is working as expected across a diverse set of users before rolling it out to everyone. By participating in experimentation, you help us improve the quality of VS Code and can help shape the future of the product through early feedback. + +To enable this experimentation system, VS Code uses the usage data telemetry data to determine which users should receive the new feature. If you disable usage data telemetry by setting `setting(telemetry.telemetryLevel)` to `error`, `crash`, or `off`, experimentation is not available to you and the roll out of new features to you might be delayed. + ## Extensions and telemetry VS Code lets you add features to the product by installing Microsoft and third-party extensions. These extensions may be collecting their own usage data and are not controlled by the `setting(telemetry.telemetryLevel)` setting. Consult the specific extension's documentation to learn about its telemetry reporting and whether it can be disabled. @@ -156,4 +164,3 @@ Please read the [extension guides telemetry document](/api/extension-guides/tele * [Centrally manage telemetry log level](/docs/setup/enterprise.md#configure-telemetry-level) - Learn how to set the telemetry log level for your organization. * [Visual Studio Code FAQ](/docs/supporting/faq.md) - Consult the Frequently Asked Questions to learn more. * [User and Workspace Settings](/docs/configure/settings.md) - Read about available options to customize VS Code. -* [Key Bindings](/docs/configure/keybindings.md) - You can easily modify commonly used keyboard shortcuts. From 08a597ee3148ca1042af20a7f15cc3e50b5a8be9 Mon Sep 17 00:00:00 2001 From: Nick Trogh Date: Mon, 13 Oct 2025 11:48:25 +0200 Subject: [PATCH 2/4] Edit pass --- docs/configure/telemetry.md | 9 ++++++--- 1 file changed, 6 insertions(+), 3 deletions(-) diff --git a/docs/configure/telemetry.md b/docs/configure/telemetry.md index 2ce0536d7b..d414ca77c0 100644 --- a/docs/configure/telemetry.md +++ b/docs/configure/telemetry.md @@ -1,7 +1,7 @@ --- ContentId: 47a2e3b1-24f2-42e6-a6e6-272c2a0f3218 DateApproved: 10/09/2025 -MetaDescription: Learn about Visual Studio Code collected telemetry and how to opt out. +MetaDescription: Learn about telemetry collection in Visual Studio Code and how to opt out. --- # Telemetry @@ -32,7 +32,7 @@ With the `setting(telemetry.telemetryLevel)` user setting, you can control the d For example, if you don't want to send any telemetry data to Microsoft, you can set the `setting(telemetry.telemetryLevel)` user setting to `off`. This will silence all telemetry events from VS Code going forward. Note that telemetry information may have been collected and sent up until the point when you disable the setting. -![disable telemetry](images/telemetry/disable-telemetry.png) +![Screenshot showing the Settings editor with telemetry disabled.](images/telemetry/disable-telemetry.png) If you use the JSON editor for your settings, add the following line: @@ -40,6 +40,9 @@ If you use the JSON editor for your settings, add the following line: "telemetry.telemetryLevel": "off" ``` +> [!IMPORTANT] +> To participate in the A/B experimentation to get early access to new features, you must have usage data enabled by setting `setting(telemetry.telemetryLevel)` to `all`. + ## Feature availability and telemetry VS Code uses an A/B experimentation system to roll out new features to a subset of users before making them generally available. This helps us validate that a new feature is working as expected across a diverse set of users before rolling it out to everyone. By participating in experimentation, you help us improve the quality of VS Code and can help shape the future of the product through early feedback. @@ -159,7 +162,7 @@ When you open a file type for which VS Code does not have any precomputed recomm Please read the [extension guides telemetry document](/api/extension-guides/telemetry.md). -## Next steps +## Related resources * [Centrally manage telemetry log level](/docs/setup/enterprise.md#configure-telemetry-level) - Learn how to set the telemetry log level for your organization. * [Visual Studio Code FAQ](/docs/supporting/faq.md) - Consult the Frequently Asked Questions to learn more. From 5b59e3c06d76a727217c2963e5c15ea52528e556 Mon Sep 17 00:00:00 2001 From: Nick Trogh Date: Mon, 13 Oct 2025 13:50:00 +0200 Subject: [PATCH 3/4] Apply feedback --- docs/configure/telemetry.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/configure/telemetry.md b/docs/configure/telemetry.md index d414ca77c0..55d372eead 100644 --- a/docs/configure/telemetry.md +++ b/docs/configure/telemetry.md @@ -47,7 +47,7 @@ If you use the JSON editor for your settings, add the following line: VS Code uses an A/B experimentation system to roll out new features to a subset of users before making them generally available. This helps us validate that a new feature is working as expected across a diverse set of users before rolling it out to everyone. By participating in experimentation, you help us improve the quality of VS Code and can help shape the future of the product through early feedback. -To enable this experimentation system, VS Code uses the usage data telemetry data to determine which users should receive the new feature. If you disable usage data telemetry by setting `setting(telemetry.telemetryLevel)` to `error`, `crash`, or `off`, experimentation is not available to you and the roll out of new features to you might be delayed. +To enable this experimentation system, VS Code uses the usage telemetry data to determine which users should receive the new feature and to validate how the feature is used. If you disable usage data telemetry by setting `setting(telemetry.telemetryLevel)` to `error`, `crash`, or `off`, we can't evaluate the feature's usage and therefore experimentation is disabled for you. As a result, the roll out of new features to you might be delayed until the feature is generally available. ## Extensions and telemetry From 2755d8f4452e9d185d9ca8226c3005061de71d9b Mon Sep 17 00:00:00 2001 From: Nick Trogh Date: Thu, 16 Oct 2025 09:59:24 +0200 Subject: [PATCH 4/4] Edit pass --- docs/configure/telemetry.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/configure/telemetry.md b/docs/configure/telemetry.md index 55d372eead..b9ecea51ac 100644 --- a/docs/configure/telemetry.md +++ b/docs/configure/telemetry.md @@ -41,13 +41,13 @@ If you use the JSON editor for your settings, add the following line: ``` > [!IMPORTANT] -> To participate in the A/B experimentation to get early access to new features, you must have usage data enabled by setting `setting(telemetry.telemetryLevel)` to `all`. +> To participate in the A/B experimentation and get early access to new features, you must have usage data enabled by setting `setting(telemetry.telemetryLevel)` to `all`. ## Feature availability and telemetry VS Code uses an A/B experimentation system to roll out new features to a subset of users before making them generally available. This helps us validate that a new feature is working as expected across a diverse set of users before rolling it out to everyone. By participating in experimentation, you help us improve the quality of VS Code and can help shape the future of the product through early feedback. -To enable this experimentation system, VS Code uses the usage telemetry data to determine which users should receive the new feature and to validate how the feature is used. If you disable usage data telemetry by setting `setting(telemetry.telemetryLevel)` to `error`, `crash`, or `off`, we can't evaluate the feature's usage and therefore experimentation is disabled for you. As a result, the roll out of new features to you might be delayed until the feature is generally available. +To enable this experimentation system, VS Code uses the usage telemetry data to determine which users should receive the new feature and to validate how the feature is used. If you disable usage data telemetry by setting `setting(telemetry.telemetryLevel)` to `error`, `crash`, or `off`, we can't evaluate the feature's usage and therefore experimentation is disabled for you. As a result, the rollout of new features to you might be delayed until the feature is generally available. ## Extensions and telemetry