Specify custom tags for Office telemetry data
Explanation
This policy setting allows you to add custom tags to the Office telemetry data that is sent by Office Telemetry Agent.
If you enable this policy setting, the specified custom tags are shown in Office Telemetry Dashboard, where you can filter the collected data by the tag name. You can specify any string that you want to categorize and filter the collected data (for example, department name, title of user, and so forth).
If you disable or do not configure this policy setting, no custom tags are shown in Office Telemetry Dashboard, and you cannot filter the data that is sent by Office Telemetry Agent.
Registry
HKEY_CURRENT_USER\software\policies\microsoft\office\16.0\osm- Value name
- not defined in the ADMX
Enable / disable values: not defined in the ADMX (see the options below).
PowerShell
PowerShell commands that write to the registry what the policy would write. Values in angle brackets (<…>) must be replaced.
Writing directly to the registry bypasses Group Policy: if a GPO manages this value, it will be rewritten at the next gpupdate; otherwise the value stays in place (the "tattooing" effect). Prefer a GPO or, locally, LGPO.exe. Run PowerShell as administrator for HKLM. Some policies need a restart or gpupdate /force.
Enable
# Enable: office16/L_OfficeOSMCustomTags
$k = 'HKCU:\software\policies\microsoft\office\16.0\osm'
if (-not (Test-Path -Path $k)) { New-Item -Path $k -Force | Out-Null }
# Tag 1
Set-ItemProperty -Path $k -Name 'tag1' -Value '<value>' -Type String
# Tag 2
Set-ItemProperty -Path $k -Name 'tag2' -Value '<value>' -Type String
# Tag 3
Set-ItemProperty -Path $k -Name 'tag3' -Value '<value>' -Type String
# Tag 4
Set-ItemProperty -Path $k -Name 'tag4' -Value '<value>' -Type StringDisable
# Disable: office16/L_OfficeOSMCustomTags
# No value is written in the "Disabled" state (nothing defined in the ADMX)Revert to "Not configured"
# Revert to "Not configured": office16/L_OfficeOSMCustomTags
$k = 'HKCU:\software\policies\microsoft\office\16.0\osm'
Remove-ItemProperty -Path $k -Name 'tag1' -ErrorAction SilentlyContinue
Remove-ItemProperty -Path $k -Name 'tag2' -ErrorAction SilentlyContinue
Remove-ItemProperty -Path $k -Name 'tag3' -ErrorAction SilentlyContinue
Remove-ItemProperty -Path $k -Name 'tag4' -ErrorAction SilentlyContinueOptions (4)
| Label | Control | Registry value | REG type | Constraints / details |
|---|---|---|---|---|
| Tag 1:L_OfficeOSMCustomTagsTag1 | Text boxtext | tag1 | REG_SZ | Max length: 64 |
| Tag 2:L_OfficeOSMCustomTagsTag2 | Text boxtext | tag2 | REG_SZ | Max length: 64 |
| Tag 3:L_OfficeOSMCustomTagsTag3 | Text boxtext | tag3 | REG_SZ | Max length: 64 |
| Tag 4:L_OfficeOSMCustomTagsTag4 | Text boxtext | tag4 | REG_SZ | Max length: 64 |
Application
Microsoft 365 Apps / Office (Microsoft) — November 2026 templates
Official templates downloaded on November 12, 2026.