Skip to content

Commit fd99436

Browse files
authored
[Telemetry] Add section about experiments (#8965)
* Add experimentation section * Edit pass * Apply feedback * Edit pass
1 parent bda8c85 commit fd99436

File tree

1 file changed

+17
-7
lines changed

1 file changed

+17
-7
lines changed

docs/configure/telemetry.md

Lines changed: 17 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -1,11 +1,13 @@
11
---
22
ContentId: 47a2e3b1-24f2-42e6-a6e6-272c2a0f3218
33
DateApproved: 10/09/2025
4-
MetaDescription: Learn about Visual Studio Code collected telemetry and how to opt out.
4+
MetaDescription: Learn about telemetry collection in Visual Studio Code and how to opt out.
55
---
66
# Telemetry
77

8-
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.
8+
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.
9+
10+
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.
911

1012
## Types of telemetry data
1113

@@ -19,7 +21,7 @@ VS Code and this page refer to three different types of data with respect to tel
1921

2022
## Disable telemetry reporting
2123

22-
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)`:
24+
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)`:
2325

2426
| | Crash Reports | Error Telemetry | Usage Data |
2527
|:------|:---------------------:|:---------------:|:--------------:|
@@ -28,16 +30,25 @@ With the `setting(telemetry.telemetryLevel)` user [setting](/docs/configure/sett
2830
| crash || - | - |
2931
| off | - | - | - |
3032

31-
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.
33+
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.
3234

33-
![disable telemetry](images/telemetry/disable-telemetry.png)
35+
![Screenshot showing the Settings editor with telemetry disabled.](images/telemetry/disable-telemetry.png)
3436

3537
If you use the JSON editor for your settings, add the following line:
3638

3739
```json
3840
"telemetry.telemetryLevel": "off"
3941
```
4042

43+
> [!IMPORTANT]
44+
> 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`.
45+
46+
## Feature availability and telemetry
47+
48+
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.
49+
50+
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.
51+
4152
## Extensions and telemetry
4253

4354
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.
@@ -151,9 +162,8 @@ When you open a file type for which VS Code does not have any precomputed recomm
151162

152163
Please read the [extension guides telemetry document](/api/extension-guides/telemetry.md).
153164

154-
## Next steps
165+
## Related resources
155166

156167
* [Centrally manage telemetry log level](/docs/setup/enterprise.md#configure-telemetry-level) - Learn how to set the telemetry log level for your organization.
157168
* [Visual Studio Code FAQ](/docs/supporting/faq.md) - Consult the Frequently Asked Questions to learn more.
158169
* [User and Workspace Settings](/docs/configure/settings.md) - Read about available options to customize VS Code.
159-
* [Key Bindings](/docs/configure/keybindings.md) - You can easily modify commonly used keyboard shortcuts.

0 commit comments

Comments
 (0)