How to Fix Custom XML Elements Warning in Microsoft Word
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.

- 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 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.
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.
Open the affected document, navigate to Developer > Document Template, and temporarily switch to a blank Normal.dotm to see if the error persists.
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.
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.

Manually Inspect the Open XML Package
Dive into the underlying XML structure of the .docx file to locate and delete the problematic Custom XML directories.
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. Download WPS Office: Visit the official WPS website and download the free version of WPS Office.
- 2. Open WPS Writer: Launch the application and select WPS Writer, the dedicated word processing module.
- 3. Open Your Document: Drag and drop your affected .docx file into WPS Writer to view and edit it seamlessly.

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.




