Open in the explorer

Specify custom tags for Office telemetry data

Type
User
GPO path
User Configuration › Policies › Administrative Templates › Microsoft Office 2016 › Telemetry Dashboard
Supported on
At least Windows Server 2003 operating systems or Windows XP Professional
ADMX file
office16.admx
Internal name
office16/L_OfficeOSMCustomTags

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 String

Disable

# 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 SilentlyContinue

Options (4)

LabelControlRegistry valueREG typeConstraints / details
Tag 1:L_OfficeOSMCustomTagsTag1Text boxtexttag1REG_SZ
Max length: 64
Tag 2:L_OfficeOSMCustomTagsTag2Text boxtexttag2REG_SZ
Max length: 64
Tag 3:L_OfficeOSMCustomTagsTag3Text boxtexttag3REG_SZ
Max length: 64
Tag 4:L_OfficeOSMCustomTagsTag4Text boxtexttag4REG_SZ
Max length: 64

Application

Microsoft 365 Apps / Office (Microsoft) — November 2026 templates

Official templates downloaded on November 12, 2026.