Office Compatibility Issues

How to Fix Custom XML Elements Warning in Microsoft Word

Adam DavisAdam Davis Oct 28, 2026 869 views

Question details

The user needs to resolve an intermittent warning in Microsoft Word stating that unsupported Custom XML elements will be removed from the document.

How to Fix the Unsupported Custom XML Elements Warning in Word
Product
Microsoft Word
Device & OS
not provided
Scenario
Opening, generating, or editing a document or template that utilizes Custom XML parts or complex add-ins.
Observed behavior
Word displays a warning about removing unsupported Custom XML elements, even when no obvious Custom XML markup is visible upon inspecting the Open XML package.
Before you start

Before inspecting the document structure, create a backup copy of your original template and the affected document to ensure you do not lose any text or metadata.

Solution 1Recommended

Inspect Document Templates and Add-ins

Identify and remove the source of the hidden Custom XML by isolating templates and checking installed add-ins.

The warning is often triggered by invisible content controls or metadata introduced during document generation. Isolating the template and add-ins helps pinpoint the exact source.

1
Isolate the Document Template

Open the affected document, navigate to Developer > Document Template, and temporarily switch to a blank Normal.dotm to see if the error persists.

2
Disable Third-Party Add-ins

Go to File > Options > Add-ins. Manage your COM Add-ins and Word Add-ins, disabling them one by one to check if an external plugin is injecting problematic Custom XML.

3
Rebuild Content Controls

If using content controls, compare a clean copy of your document with the affected file. Try transferring only the text (without carrying over embedded content controls) into a fresh document.

Inspect Document Templates and Add-ins
Developer Tab Requirement: If you do not see the Developer tab, right-click the ribbon, select 'Customize the Ribbon', and check the box next to 'Developer' in the right-hand pane.
Free Microsoft Office alternative

Avoid Legacy Compatibility Errors with WPS Office

If you frequently encounter legacy XML warnings and compatibility issues in Microsoft Word, consider switching to WPS Office. It provides a highly compatible environment for your document processing needs, avoiding many of the clutter and deprecation errors found in older Microsoft formats.

  1. 1. Download WPS Office: Visit the official WPS website and download the free version of WPS Office.
  2. 2. Open WPS Writer: Launch the application and select WPS Writer, the dedicated word processing module.
  3. 3. Open Your Document: Drag and drop your affected .docx file into WPS Writer to view and edit it seamlessly.
Fully compatible with Microsoft Office formats including .docx, .xlsx, and .pptx.Free and lightweight alternative to Microsoft 365.Seamlessly opens complex documents without triggering legacy XML errors.Familiar user interface makes migration from Microsoft Word effortless.
microsoft office alternative - wps office

Frequently Asked Questions

Why does Word say unsupported Custom XML elements will be removed?

This warning typically appears because older versions of Word allowed custom XML tagging that Microsoft later deprecated and removed due to a patent dispute. The document or its underlying template likely still contains hidden references to these old elements.

Can content controls trigger the Custom XML warning?

Yes, if content controls in your document are mapped to a Custom XML part that is unsupported, corrupted, or generated by a third-party add-in, Word may trigger this warning during document generation or when editing.

Will ignoring this Custom XML warning affect my document content?

Word will automatically remove the unsupported custom XML tags. The visible text and layout usually remain completely intact, but any automated data mapping or metadata tracking reliant on those specific XML elements will break.