Custom markup warning

UserNeeds changes for IntuneL_CustomMarkupWarning

Supported on SUPPORTED_Windows7 (defined in the Windows templates)

5568.1000

What it does

This policy setting specifies how Word behaves when opening a document that contains custom XML markup. If you enable this policy setting, you can set the behavior to one of the following: - 0: Do not prompt the user and silently remove the custom XML markup. - 1: Prompt the user regarding the loss of custom XML markup. This is the default option. - 2: Prompt the user regarding the loss of custom XML markup, and do not allow them to suppress this prompt. - 3: Prompt the user regarding the loss of custom XML markup, and open the file read-only. - 4: Prompt the user regarding the loss of custom XML markup, do not allow them to suppress this prompt, and open the file read-only. - 5: Do not prompt the user and silently remove the custom XML markup, but open the file read-only.

What it writes

Hive: HKEY_CURRENT_USER
Registry key: software\policies\microsoft\office\16.0\word\options

Why it needs changes for Intune

Policy references a Windows supportedOn definition.
ADMX-INTUNE-WINDOWS-SUPPORTEDON-REFERENCE

Options

Option	Type	Registry value	Allowed values
Custom markup warningDefault: Prompt	Drop-down list	`custommarkupwarning`	Do not prompt`0` Prompt`1` Always prompt`2` Prompt and open the file read-only`3` Always prompt and open the file read-only`4` Do not prompt and open the file read-only`5`

Configure and deploy

Choose a state and the option values; the output below is generated from the template for exactly that.

Enabled · User · template defaults

Registry file (.reg)

Windows Registry Editor Version 5.00

[HKEY_CURRENT_USER\software\policies\microsoft\office\16.0\word\options]
"custommarkupwarning"=dword:00000001

PowerShell

$ErrorActionPreference = 'Stop'

function Set-RegistryValue {
    param(
        [Parameter(Mandatory = $true)][string] $Path,
        [Parameter(Mandatory = $true)][string] $Name,
        [Parameter(Mandatory = $true)][string] $PropertyType,
        [Parameter(Mandatory = $true)][object] $Value
    )

    if (-not (Test-Path -LiteralPath $Path)) {
        New-Item -Path $Path -Force | Out-Null
    }

    New-ItemProperty -LiteralPath $Path -Name $Name -PropertyType $PropertyType -Value $Value -Force | Out-Null
}

function Remove-RegistryValue {
    param(
        [Parameter(Mandatory = $true)][string] $Path,
        [Parameter(Mandatory = $true)][string] $Name
    )

    if (Test-Path -LiteralPath $Path) {
        Remove-ItemProperty -LiteralPath $Path -Name $Name -Force -ErrorAction SilentlyContinue
    }
}

function Clear-RegistryKeyValues {
    param(
        [Parameter(Mandatory = $true)][string] $Path
    )

    if (-not (Test-Path -LiteralPath $Path)) {
        return
    }

    foreach ($propertyName in (Get-Item -LiteralPath $Path).Property) {
        Remove-ItemProperty -LiteralPath $Path -Name $propertyName -Force -ErrorAction SilentlyContinue
    }
}

# Policy: Custom markup warning
# Name: L_CustomMarkupWarning
# Scope: User
# State: Enabled
# Source: word16.admx

Set-RegistryValue -Path 'Registry::HKEY_CURRENT_USER\software\policies\microsoft\office\16.0\word\options' -Name 'custommarkupwarning' -PropertyType 'DWord' -Value 1

The OMA-URI is an inferred ADMX-backed Policy CSP candidate derived from the source ADMX file name and policy name.
Some Microsoft policies use built-in Policy CSP pages whose area names don't match the ADMX file name, so verify the candidate against Microsoft Learn before deployment.

ADMX profile candidate (OMA-URI)

./User/Vendor/MSFT/Policy/Config/ADMX_word16/L_CustomMarkupWarning

ADMX SyncML candidate

<SyncML xmlns="SYNCML:SYNCML1.2">
  <SyncBody>
    <Replace>
      <CmdID>1</CmdID>
      <Item>
        <Meta>
          <Format>chr</Format>
          <Type>text/plain</Type>
        </Meta>
        <Target>
          <LocURI>./User/Vendor/MSFT/Policy/Config/ADMX_word16/L_CustomMarkupWarning</LocURI>
        </Target>
        <Data>&lt;enabled/&gt;
&lt;data id="L_CustomMarkupWarningDropID" value="1"/&gt;</Data>
      </Item>
    </Replace>
    <Final/>
  </SyncBody>
</SyncML>

Intune remediation scripts

Detection

$ErrorActionPreference = 'Stop'
$reasons = [System.Collections.Generic.List[string]]::new()

function Test-RegistryValueExists {
    param(
        [Parameter(Mandatory = $true)][string] $Path,
        [Parameter(Mandatory = $true)][string] $Name
    )

    if (-not (Test-Path -LiteralPath $Path)) {
        return $false
    }

    return $null -ne (Get-ItemProperty -LiteralPath $Path -Name $Name -ErrorAction SilentlyContinue)
}

function Test-RegistryValueEquals {
    param(
        [Parameter(Mandatory = $true)][string] $Path,
        [Parameter(Mandatory = $true)][string] $Name,
        [Parameter(Mandatory = $true)][string] $Kind,
        [Parameter(Mandatory = $true)][object] $Expected
    )

    if (-not (Test-Path -LiteralPath $Path)) {
        return $false
    }

    $valueObject = Get-ItemProperty -LiteralPath $Path -Name $Name -ErrorAction SilentlyContinue
    if ($null -eq $valueObject) {
        return $false
    }

    $actual = $valueObject.$Name
    switch ($Kind) {
        'String' { return [string]$actual -ceq [string]$Expected }
        'ExpandString' { return [string]$actual -ceq [string]$Expected }
        'DWord' { return [uint32]$actual -eq [uint32]$Expected }
        'QWord' { return [uint64]$actual -eq [uint64]$Expected }
        'MultiString' {
            $actualArray = @($actual)
            $expectedArray = @($Expected)
            if ($actualArray.Count -ne $expectedArray.Count) { return $false }
            for ($index = 0; $index -lt $actualArray.Count; $index++) {
                if ([string]$actualArray[$index] -cne [string]$expectedArray[$index]) { return $false }
            }
            return $true
        }
        'Binary' {
            $actualArray = [byte[]]$actual
            $expectedArray = [byte[]]$Expected
            if ($actualArray.Length -ne $expectedArray.Length) { return $false }
            for ($index = 0; $index -lt $actualArray.Length; $index++) {
                if ($actualArray[$index] -ne $expectedArray[$index]) { return $false }
            }
            return $true
        }
        default { return [string]$actual -ceq [string]$Expected }
    }
}

# Policy: Custom markup warning
# Name: L_CustomMarkupWarning
# Scope: User
# State: Enabled
# Source: word16.admx

$isMatch = Test-RegistryValueEquals -Path 'Registry::HKEY_CURRENT_USER\software\policies\microsoft\office\16.0\word\options' -Name 'custommarkupwarning' -Kind 'DWord' -Expected 1
if (-not $isMatch) {
    $reasons.Add('Value mismatch: HKEY_CURRENT_USER\software\policies\microsoft\office\16.0\word\options\custommarkupwarning') | Out-Null
}

if ($reasons.Count -eq 0) {
    Write-Output 'Compliant'
    exit 0
}

$reasons | ForEach-Object { Write-Output $_ }
exit 1

Remediation

$ErrorActionPreference = 'Stop'

function Set-RegistryValue {
    param(
        [Parameter(Mandatory = $true)][string] $Path,
        [Parameter(Mandatory = $true)][string] $Name,
        [Parameter(Mandatory = $true)][string] $PropertyType,
        [Parameter(Mandatory = $true)][object] $Value
    )

    if (-not (Test-Path -LiteralPath $Path)) {
        New-Item -Path $Path -Force | Out-Null
    }

    New-ItemProperty -LiteralPath $Path -Name $Name -PropertyType $PropertyType -Value $Value -Force | Out-Null
}

function Remove-RegistryValue {
    param(
        [Parameter(Mandatory = $true)][string] $Path,
        [Parameter(Mandatory = $true)][string] $Name
    )

    if (Test-Path -LiteralPath $Path) {
        Remove-ItemProperty -LiteralPath $Path -Name $Name -Force -ErrorAction SilentlyContinue
    }
}

function Clear-RegistryKeyValues {
    param(
        [Parameter(Mandatory = $true)][string] $Path
    )

    if (-not (Test-Path -LiteralPath $Path)) {
        return
    }

    foreach ($propertyName in (Get-Item -LiteralPath $Path).Property) {
        Remove-ItemProperty -LiteralPath $Path -Name $propertyName -Force -ErrorAction SilentlyContinue
    }
}

# Policy: Custom markup warning
# Name: L_CustomMarkupWarning
# Scope: User
# State: Enabled
# Source: word16.admx

Set-RegistryValue -Path 'Registry::HKEY_CURRENT_USER\software\policies\microsoft\office\16.0\word\options' -Name 'custommarkupwarning' -PropertyType 'DWord' -Value 1

History 1 retained release

5568.100010 Aug 2026
- Already present in the first release ChangeIntel keeps.

Template

Internal name: L_CustomMarkupWarning
Namespace: word16.Office.Microsoft.Policies.Windows
Template file: word16.admx
Release: Microsoft 365 Apps 5568.1000 · file set 8be05d876aae137d…

Definition, editor controls and support

Definition

<policy class="User" displayName="$(string.L_CustomMarkupWarning)" explainText="$(string.L_CustomMarkupWarningExplainText)" key="software\policies\microsoft\office\16.0\word\options" name="L_CustomMarkupWarning" presentation="$(presentation.L_CustomMarkupWarning)" xmlns="http://schemas.microsoft.com/GroupPolicy/2006/07/PolicyDefinitions">
      <parentCategory ref="word16.Office.Microsoft.Policies.Windows:L_Advanced" />
      <supportedOn ref="Microsoft.Policies.Windows:SUPPORTED_Windows7" />
      <elements>
        <enum id="L_CustomMarkupWarningDropID" valueName="custommarkupwarning">
          <item displayName="$(string.L_CustomMarkupWarningNoPrompt)">
            <value>
              <decimal value="0" />
            </value>
          </item>
          <item displayName="$(string.L_CustomMarkupWarningPrompt)">
            <value>
              <decimal value="1" />
            </value>
          </item>
          <item displayName="$(string.L_CustomMarkupWarningAlwaysPrompt)">
            <value>
              <decimal value="2" />
            </value>
          </item>
          <item displayName="$(string.L_CustomMarkupWarningPromptReadonly)">
            <value>
              <decimal value="3" />
            </value>
          </item>
          <item displayName="$(string.L_CustomMarkupWarningAlwaysPromptReadonly)">
            <value>
              <decimal value="4" />
            </value>
          </item>
          <item displayName="$(string.L_CustomMarkupWarningNoPromptReadyonly)">
            <value>
              <decimal value="5" />
            </value>
          </item>
        </enum>
      </elements>
    </policy>

Editor controls

<presentation id="L_CustomMarkupWarning" xmlns="http://schemas.microsoft.com/GroupPolicy/2006/07/PolicyDefinitions">
        <dropdownList defaultItem="1" noSort="true" refId="L_CustomMarkupWarningDropID">Custom markup warning:</dropdownList>
      </presentation>

Supported platforms and category

word16.Office.Microsoft.Policies.Windows:category:L_Advanced
<category displayName="$(string.L_Advanced)" name="L_Advanced" xmlns="http://schemas.microsoft.com/GroupPolicy/2006/07/PolicyDefinitions">
      <parentCategory ref="word16.Office.Microsoft.Policies.Windows:L_WordOptions" />
    </category>
word16.Office.Microsoft.Policies.Windows:category:L_MicrosoftOfficeWord
<category displayName="$(string.L_MicrosoftOfficeWord)" name="L_MicrosoftOfficeWord" xmlns="http://schemas.microsoft.com/GroupPolicy/2006/07/PolicyDefinitions" />
word16.Office.Microsoft.Policies.Windows:category:L_WordOptions
<category displayName="$(string.L_WordOptions)" name="L_WordOptions" xmlns="http://schemas.microsoft.com/GroupPolicy/2006/07/PolicyDefinitions">
      <parentCategory ref="word16.Office.Microsoft.Policies.Windows:L_MicrosoftOfficeWord" />
    </category>
word16.Office.Microsoft.Policies.Windows:unresolved:Microsoft.Policies.Windows:SUPPORTED_Windows7
<unresolved reference="Microsoft.Policies.Windows:SUPPORTED_Windows7" />
word16.Office.Microsoft.Policies.Windows:category:L_Advanced
<category displayName="$(string.L_Advanced)" name="L_Advanced" xmlns="http://schemas.microsoft.com/GroupPolicy/2006/07/PolicyDefinitions">
      <parentCategory ref="word16.Office.Microsoft.Policies.Windows:L_WordOptions" />
    </category>
<strings><string id="word16.Office.Microsoft.Policies.Windows:L_Advanced">Advanced</string></strings>
word16.Office.Microsoft.Policies.Windows:category:L_MicrosoftOfficeWord
<category displayName="$(string.L_MicrosoftOfficeWord)" name="L_MicrosoftOfficeWord" xmlns="http://schemas.microsoft.com/GroupPolicy/2006/07/PolicyDefinitions" />
<strings><string id="word16.Office.Microsoft.Policies.Windows:L_MicrosoftOfficeWord">Microsoft Word 2016</string></strings>
word16.Office.Microsoft.Policies.Windows:category:L_WordOptions
<category displayName="$(string.L_WordOptions)" name="L_WordOptions" xmlns="http://schemas.microsoft.com/GroupPolicy/2006/07/PolicyDefinitions">
      <parentCategory ref="word16.Office.Microsoft.Policies.Windows:L_MicrosoftOfficeWord" />
    </category>
<strings><string id="word16.Office.Microsoft.Policies.Windows:L_WordOptions">Word Options</string></strings>