From ef1965efe04f854d9d70848844e217d964e2ef5c Mon Sep 17 00:00:00 2001 From: Jessica Dene Earley-Cha <12740421+chatasweetie@users.noreply.github.com> Date: Wed, 21 Jan 2026 11:07:12 -0800 Subject: [PATCH] Update DATA_AND_PRIVACY to reflect current status (#44844) ## Summary of the Pull Request Updates the telemetry events documentation in `DATA_AND_PRIVACY.md` to ensure completeness and improve organization. - Added missing & new events - Removed obsolete events (deprecated or unused event) - Alphabetized all modules for easier navigation and maintenance - Made all tables uniform with `table-layout:fixed` ## PR Checklist - [ ] Closes: #xxx - [ ] **Communication:** I've discussed this with core contributors already. If the work hasn't been agreed, this work might be rejected - [ ] **Tests:** Added/updated and all pass - [ ] **Localization:** All end-user-facing strings can be localized - [ ] **Dev docs:** Added/updated - [ ] **New binaries:** Added on the required places - [ ] [JSON for signing](https://github.com/microsoft/PowerToys/blob/main/.pipelines/ESRPSigning_core.json) for new binaries - [ ] [WXS for installer](https://github.com/microsoft/PowerToys/blob/main/installer/PowerToysSetup/Product.wxs) for new binaries and localization folder - [ ] [YML for CI pipeline](https://github.com/microsoft/PowerToys/blob/main/.pipelines/ci/templates/build-powertoys-steps.yml) for new test projects - [ ] [YML for signed pipeline](https://github.com/microsoft/PowerToys/blob/main/.pipelines/release.yml) - [ ] **Documentation updated:** If checked, please file a pull request on [our docs repo](https://github.com/MicrosoftDocs/windows-uwp/tree/docs/hub/powertoys) and link it here: #xxx ## Detailed Description of the Pull Request / Additional comments ## Validation Steps Performed --- DATA_AND_PRIVACY.md | 420 +++++++++++++++++++++++++++++++++++--------- 1 file changed, 334 insertions(+), 86 deletions(-) diff --git a/DATA_AND_PRIVACY.md b/DATA_AND_PRIVACY.md index dd46dd2285..81dc855e63 100644 --- a/DATA_AND_PRIVACY.md +++ b/DATA_AND_PRIVACY.md @@ -30,7 +30,11 @@ _If you want to find diagnostic data events in the source code, these two links - [C++ events](https://github.com/search?q=repo%3Amicrosoft%2FPowerToys+ProjectTelemetryPrivacyDataTag&type=code) ### General - +
+ + + + @@ -43,6 +47,18 @@ _If you want to find diagnostic data events in the source code, these two links + + + + + + + + + + + + @@ -59,6 +75,18 @@ _If you want to find diagnostic data events in the source code, these two links + + + + + + + + + + + + @@ -67,6 +95,14 @@ _If you want to find diagnostic data events in the source code, these two links + + + + + + + + @@ -82,11 +118,19 @@ _If you want to find diagnostic data events in the source code, these two links
Event Name DescriptionMicrosoft.PowerToys.GeneralSettingsChanged Logs changes made to general settings within PowerToys.
Microsoft.PowerToys.Install_FailTriggered when the PowerToys installation process encounters an error and fails to complete.
Microsoft.PowerToys.Repair_CancelTriggered when a PowerToys repair operation is cancelled by the user before completion.
Microsoft.PowerToys.Repair_FailTriggered when the PowerToys repair operation fails to complete successfully due to an error.
Microsoft.PowerToys.Runner_Launch Indicates when the PowerToys Runner is launched.Microsoft.PowerToys.ScoobeStartedEvent Triggered when SCOOBE (Secondary Out-of-box experience) starts.
Microsoft.PowerToys.ShortcutConflictControlClickedEventTriggered when a user clicks on the Shortcut Conflict Control button in the PowerToys Settings UI Dashboard.
Microsoft.PowerToys.ShortcutConflictDetectedEventTriggered when keyboard shortcut conflicts are detected in the PowerToys Settings UI Dashboard.
Microsoft.PowerToys.ShortcutConflictResolvedEventTriggered when a keyboard shortcut conflict is resolved in the PowerToys Settings UI.
Microsoft.PowerToys.TrayFlyoutActivatedEvent Indicates when the tray flyout menu is activated.Microsoft.PowerToys.TrayFlyoutModuleRunEvent Logs when a utility from the tray flyout menu is run.
Microsoft.PowerToys.UnInstall_CancelTriggered when the PowerToys uninstallation process is cancelled by the user before completion.
Microsoft.PowerToys.UnInstall_FailTriggered when the PowerToys uninstallation process fails to complete successfully due to an error.
Microsoft.PowerToys.Uninstall_Success Logs when PowerToys is successfully uninstalled (who would do such a thing!).
### OOBE (Out-of-box experience) - +
+ + + + + + + + @@ -99,10 +143,18 @@ _If you want to find diagnostic data events in the source code, these two links + + + +
Event Name Description
Microsoft.PowerToys.OobeModuleRunEventTriggered when a user clicks to run or launch a PowerToys module directly from the OOBE (out-of-box experience) interface.
Microsoft.PowerToys.OobeSectionEvent Occurs when OOBE is shown to the user.Microsoft.PowerToys.OobeStartedEvent Indicates when the out-of-box experience has been initiated.
Microsoft.PowerToys.OobeVariantAssignmentEventThis event logs A/B testing assignments for experimental features, helping track which users are in control or alternate groups for feature experiments.
### Advanced Paste - +
+ + + + @@ -170,7 +222,11 @@ _If you want to find diagnostic data events in the source code, these two links
Event Name Description
### Always on Top - +
+ + + + @@ -190,7 +246,11 @@ _If you want to find diagnostic data events in the source code, these two links
Event Name Description
### Awake - +
+ + + + @@ -218,7 +278,11 @@ _If you want to find diagnostic data events in the source code, these two links
Event Name Description
### Color Picker - +
+ + + + @@ -235,18 +299,14 @@ _If you want to find diagnostic data events in the source code, these two links - - - - - - - -
Event Name DescriptionMicrosoft.PowerToys.ColorPicker_Settings Triggered when the settings for the Color Picker are accessed or modified.
Microsoft.PowerToys.ColorPickerCancelledEventOccurs when a color picking action is cancelled by the user.
Microsoft.PowerToys.ColorPickerShowEventTriggered when the Color Picker UI is displayed on the screen.
### Command Not Found - +
+ + + + @@ -259,10 +319,6 @@ _If you want to find diagnostic data events in the source code, these two links - - - - @@ -271,7 +327,11 @@ _If you want to find diagnostic data events in the source code, these two links ### Command Palette -
Event Name DescriptionMicrosoft.PowerToys.CmdNotFoundInstallEvent Triggered when a Command Not Found is installed.
Microsoft.PowerToys.CmdNotFoundInstanceCreatedEventOccurs when an instance of a Command Not Found is created.
Microsoft.PowerToys.CmdNotFoundUninstallEvent Triggered when Command Not Found is uninstalled after being previously installed.
+
+ + + + @@ -335,7 +395,11 @@ _If you want to find diagnostic data events in the source code, these two links
Event Name Description
### Crop And Lock - +
+ + + + @@ -344,10 +408,26 @@ _If you want to find diagnostic data events in the source code, these two links + + + + + + + + + + + + + + + @@ -358,8 +438,28 @@ _If you want to find diagnostic data events in the source code, these two links
Event Name DescriptionMicrosoft.PowerToys.CropAndLock_ActivateReparent Triggered when the cropping interface is activated for reparenting the cropped content.
Microsoft.PowerToys.CropAndLock_ActivateScreenshotTriggered when the screenshot mode is activated in Crop and Lock.
Microsoft.PowerToys.CropAndLock_ActivateThumbnail Occurs when the thumbnail view for cropped content is activated.
Microsoft.PowerToys.CropAndLock_CreateReparentWindowTriggered when a reparent window is created in Crop and Lock mode.
Microsoft.PowerToys.CropAndLock_CreateScreenshotWindowTriggered when a screenshot window is created in Crop and Lock mode.
Microsoft.PowerToys.CropAndLock_CreateThumbnailWindowTriggered when a thumbnail window is created in Crop and Lock mode.<-/td> +
Microsoft.PowerToys.CropAndLock_EnableCropAndLock Triggered when Crop and Lock is enabled.
+### Cursor Wrap + + + + + + + + + + + + + +
Event NameDescription
Microsoft.PowerToys.CursorWrap_EnableCursorWrapTriggered when Cursor Wrap is enabled or disabled.
+ ### Environment Variables - +
+ + + + @@ -387,7 +487,11 @@ _If you want to find diagnostic data events in the source code, these two links
Event Name Description
### FancyZones - +
+ + + + @@ -404,6 +508,10 @@ _If you want to find diagnostic data events in the source code, these two links + + + + @@ -416,10 +524,6 @@ _If you want to find diagnostic data events in the source code, these two links - - - - @@ -432,10 +536,6 @@ _If you want to find diagnostic data events in the source code, these two links - - - - @@ -456,10 +556,50 @@ _If you want to find diagnostic data events in the source code, these two links + + + + + + + + +
Event Name DescriptionMicrosoft.PowerToys.FancyZones_EnableFancyZones Occurs when FancyZones is enabled.
Microsoft.PowerToys.FancyZones_ErrorTriggered when an error occurs within the FancyZones module. This event logs critical errors to help diagnose and troubleshoot issues with FancyZones functionality, such as failures to set up Windows hooks or other system-level operations required for window management.
Microsoft.PowerToys.FancyZones_KeyboardSnapWindowToZone Triggered when a window is snapped to a zone using the keyboard.Microsoft.PowerToys.FancyZones_MoveOrResizeStarted Triggered when a window move or resize action is initiated.
Microsoft.PowerToys.FancyZones_MoveSizeEndOccurs when the moving or resizing of a window has ended.
Microsoft.PowerToys.FancyZones_OnKeyDown Triggered when a key is pressed down while interacting with zones.Microsoft.PowerToys.FancyZones_Settings Triggered when FancyZones settings are accessed or modified.
Microsoft.PowerToys.FancyZones_SettingsChangedOccurs when there is a change in the FancyZones settings.
Microsoft.PowerToys.FancyZones_SnapNewWindowIntoZone Triggered when a new window is snapped into a zone.Microsoft.PowerToys.FancyZones_CLICommand Triggered when a FancyZones CLI command is executed, logging the command name and success status.
Microsoft.PowerToys.FancyZonesEditorStartEventTriggered when the FancyZones Editor application starts. This logs the initialization of the editor UI, which is used to create and configure custom zone layouts.
Microsoft.PowerToys.FancyZonesEditorStartFinishEventTriggered when the FancyZones Editor has completed loading and is ready for user interaction.
+ +### File Locksmith + + + + + + + + + + + + + + + + + + + + + + + + +
Event NameDescription
Microsoft.PowerToys.FileLocksmith_EnableFileLocksmithTriggered when File Locksmith is enabled.
Microsoft.PowerToys.FileLocksmith_InvokedOccurs when File Locksmith is invoked.
Microsoft.PowerToys.FileLocksmith_InvokedRetTriggered when File Locksmith invocation returns a result.
Microsoft.PowerToys.FileLocksmith_QueryContextMenuErrorOccurs when there is an error querying the context menu for File Locksmith.
### FileExplorerAddOns - +
+ + + + @@ -496,6 +636,10 @@ _If you want to find diagnostic data events in the source code, these two links + + + + @@ -504,6 +648,10 @@ _If you want to find diagnostic data events in the source code, these two links + + + + @@ -520,6 +668,10 @@ _If you want to find diagnostic data events in the source code, these two links + + + + @@ -528,6 +680,10 @@ _If you want to find diagnostic data events in the source code, these two links + + + + @@ -542,32 +698,12 @@ _If you want to find diagnostic data events in the source code, these two links
Event Name DescriptionMicrosoft.PowerToys.MarkdownFilePreviewed Triggered when a Markdown file is previewed in File Explorer.
Microsoft.PowerToys.MarkdownFilePreviewErrorTriggered when there is an error previewing a Markdown file in File Explorer.
Microsoft.PowerToys.PdfFileHandlerLoaded Occurs when a PDF file handler is loaded.Microsoft.PowerToys.PdfFilePreviewed Triggered when a PDF file is previewed in File Explorer.
Microsoft.PowerToys.PdfFilePreviewErrorTriggered when there is an error previewing a PDF file in File Explorer.
Microsoft.PowerToys.PowerPreview_Enabled Occurs when preview is enabled.Microsoft.PowerToys.PowerPreview_TweakUISettings_InitSet__ErrorLoadingFile Triggered when there is an error loading a file during Tweak UI settings initialization.
Microsoft.PowerToys.PowerPreview_TweakUISettings_SetConfig__InvalidJSONGivenTriggered when invalid JSON is provided to the Power Preview settings configuration
Microsoft.PowerToys.PowerPreview_TweakUISettings_SuccessfullyUpdatedSettings Occurs when the Tweak UI settings for Power Preview are successfully updated.Microsoft.PowerToys.QoiFilePreviewed Triggered when a QOI file is previewed in File Explorer.
Microsoft.PowerToys.QoiFilePreviewErrorTriggered when there is an error previewing a QOI (Quite OK Image) file in File Explorer.
Microsoft.PowerToys.SvgFileHandlerLoaded Occurs when an SVG file handler is loaded.
-### File Locksmith - - - - - - - - - - - - - - - - - - - - - -
Event NameDescription
Microsoft.PowerToys.FileLocksmith_EnableFileLocksmithTriggered when File Locksmith is enabled.
Microsoft.PowerToys.FileLocksmith_InvokedOccurs when File Locksmith is invoked.
Microsoft.PowerToys.FileLocksmith_InvokedRetTriggered when File Locksmith invocation returns a result.
Microsoft.PowerToys.FileLocksmith_QueryContextMenuErrorOccurs when there is an error querying the context menu for File Locksmith.
- ### Find My Mouse - +
+ + + + @@ -583,7 +719,11 @@ _If you want to find diagnostic data events in the source code, these two links
Event Name Description
### Hosts File Editor - +
+ + + + @@ -600,10 +740,22 @@ _If you want to find diagnostic data events in the source code, these two links + + + + + + + +
Event Name DescriptionMicrosoft.PowerToys.HostsFileEditorOpenedEvent Fires when Hosts File Editor is opened.
Microsoft.PowerToys.HostEditorStartEventTriggered when the Hosts File Editor application starts. This logs the initialization of the Hosts File Editor UI with a timestamp.
Microsoft.PowerToys.HostEditorStartFinishEventTriggered when the Hosts File Editor has completed loading and is ready for user interaction.
### Image Resizer - +
+ + + + @@ -620,10 +772,18 @@ _If you want to find diagnostic data events in the source code, these two links + + + +
Event Name DescriptionMicrosoft.PowerToys.ImageResizer_InvokedRet Fires when the Image Resizer operation is completed and returns a result.
Microsoft.PowerToys.ImageResizer_QueryContextMenuErrorTriggered when there is an error querying the context menu for Image Resizer.
### Keyboard Manager - +
+ + + + @@ -636,10 +796,22 @@ _If you want to find diagnostic data events in the source code, these two links + + + + + + + + + + + + @@ -703,7 +875,11 @@ _If you want to find diagnostic data events in the source code, these two links
Event Name DescriptionMicrosoft.PowerToys.KeyboardManager_AppSpecificShortcutRemapCount Logs the number of application-specific shortcut remaps configured by the user.
Microsoft.PowerToys.KeyboardManager_AppSpecificShortcutToKeyRemapInvokedLogs each instance when an application-specific shortcut-to-key remap is used.
Microsoft.PowerToys.KeyboardManager_AppSpecificShortcutToShortcutRemapInvoked Logs each instance when an application-specific shortcut-to-shortcut remap is used.
Microsoft.PowerToys.KeyboardManager_ErrorTriggered when an error occurs in Keyboard Manager. This logs the error code, error message, and the method name where the error occurred.
Microsoft.PowerToys.KeyboardManager_ErrorSendingKeyAndShortcutRemapLoadedConfigurationTriggered when there is an error sending remapping configuration telemetry. This occurs when Keyboard Manager fails to report the loaded key and shortcut remap configurations
Microsoft.PowerToys.KeyboardManager_DailyAppSpecificShortcutToKeyRemapInvoked Logs the daily count of application-specific shortcut-to-key remaps executed by the user.
### Light Switch - +
+ + + + @@ -727,7 +903,11 @@ _If you want to find diagnostic data events in the source code, these two links
Event Name Description
### Mouse Highlighter - +
+ + + + @@ -740,10 +920,18 @@ _If you want to find diagnostic data events in the source code, these two links + + + +
Event Name DescriptionMicrosoft.PowerToys.MouseHighlighter_StartHighlightingSession Occurs when a new highlighting session is started.
Microsoft.PowerToys.MouseHighlighter_StartSpotlightSessionTriggered when a spotlight session is started in Mouse Highlighter. This occurs when the user activates the spotlight mode.
### Mouse Jump - +
+ + + + @@ -767,7 +955,11 @@ _If you want to find diagnostic data events in the source code, these two links
Event Name Description
### Mouse Pointer Crosshairs - +
+ + + + @@ -783,7 +975,11 @@ _If you want to find diagnostic data events in the source code, these two links
Event Name Description
### Mouse Without Borders - +
+ + + + @@ -835,7 +1031,11 @@ _If you want to find diagnostic data events in the source code, these two links
Event Name Description
### New+ - +
+ + + + @@ -867,7 +1067,11 @@ _If you want to find diagnostic data events in the source code, these two links
Event Name Description
### Peek - +
+ + + + @@ -900,10 +1104,18 @@ _If you want to find diagnostic data events in the source code, these two links + + + +
Event Name DescriptionMicrosoft.PowerToys.Peek_Settings Triggered when the settings for Peek are modified.
Microsoft.PowerToys.Peek_SpaceModeEnabledTriggered when the Space key activation mode is enabled or disabled in Peek
### PowerRename - +
+ + + + @@ -935,7 +1147,11 @@ _If you want to find diagnostic data events in the source code, these two links
Event Name Description
### PowerToys Run - +
+ + + + @@ -976,14 +1192,14 @@ _If you want to find diagnostic data events in the source code, these two links - - - -
Event Name DescriptionMicrosoft.PowerToys.RunPluginsSettingsEvent Triggered when the settings for PowerToys Run plugins are accessed or modified.
Microsoft.PowerToys.WindowWalker_EnableWindowWalkerTriggered when the Window Walker plugin is enabled.
### Quick Accent - +
+ + + + @@ -999,7 +1215,11 @@ _If you want to find diagnostic data events in the source code, these two links
Event Name Description
### Registry Preview - +
+ + + + @@ -1012,10 +1232,22 @@ _If you want to find diagnostic data events in the source code, these two links + + + + + + + +
Event Name DescriptionMicrosoft.PowerToys.RegistryPreview_EnableRegistryPreview Occurs when Registry Preview is enabled.
Microsoft.PowerToys.RegistryPreviewEditorStartEventTriggered when the Registry Preview application starts. This logs the initialization of the Registry Preview UI with a timestamp.
Microsoft.PowerToys.RegistryPreviewEditorStartFinishEventTriggered when the Registry Preview application has completed loading and is ready for user interaction.
### Screen Ruler - +
+ + + + @@ -1035,7 +1267,11 @@ _If you want to find diagnostic data events in the source code, these two links
Event Name Description
### Shortcut Guide - +
+ + + + @@ -1051,7 +1287,11 @@ _If you want to find diagnostic data events in the source code, these two links
Event Name Description
### Text Extractor - +
+ + + + @@ -1075,15 +1315,15 @@ _If you want to find diagnostic data events in the source code, these two links
Event Name Description
### Workspaces - +
+ + + + - - - - @@ -1105,13 +1345,21 @@ _If you want to find diagnostic data events in the source code, these two links - - + + + + + +
Event Name Description
Microsoft.PowerToys.Projects_CLIUsageLogs usage of command-line arguments for launching apps.
Microsoft.PowerToys.Workspaces_CreateEvent Triggered when a new workspace is created.Triggered when a workspace is launched.
Microsoft.PowerToys.Workspaces_SettingsLogs changes to workspaces settings.Microsoft.PowerToys.WorkspacesEditorStartEventTriggered when the Workspaces Editor application starts. This logs the initialization of the Workspaces Editor UI with a timestamp.
Microsoft.PowerToys.WorkspacesEditorStartFinishEventTriggered when the Workspaces Editor has completed loading and is ready for user interaction.
### ZoomIt - +
+ + + +
Event Name Description