</>
ValidateHTML

Multiple Root Elements in XML

A well-formed XML document must have exactly one root element that contains all other elements. Having two or more top-level elements (after the XML declaration) violates this fundamental rule. The parser reads the first root element successfully, then encounters a second top-level element and reports an error.

Find this error in your own code. Paste your XML, free and instant.Open the XML validator

Why It Matters

The XML parser stops after the first root element closes and rejects everything that follows. This is a structural problem that requires wrapping all content in a single parent element. No partial parsing is possible.

Common Causes

  • Outputting a list of records as repeated top-level elements without a surrounding container element.
  • Concatenating two complete XML documents or fragments into one file, leaving two root elements side by side.
  • Appending new entries to the end of a file, after the original root element has already closed.

Code Examples

Invalid XML
<?xml version="1.0" encoding="UTF-8"?>
<user>
  <name>Alice</name>
</user>
<user>
  <name>Bob</name>
</user>
Valid XML
<?xml version="1.0" encoding="UTF-8"?>
<users>
  <user>
    <name>Alice</name>
  </user>
  <user>
    <name>Bob</name>
  </user>
</users>

How to Fix

  • 1Wrap all top-level elements inside a single root element: <users>...</users>.
  • 2Choose a meaningful name for the root element that describes the collection.
  • 3If merging multiple XML fragments, always create a wrapper element first.
  • 4Remember that the XML declaration (<?xml ...?>) is not an element and does not count as a root.

Frequently Asked Questions

Why can an XML document have only one root?
The XML specification defines a document as having exactly one element, the document element, that contains all others. A single root gives the document a single tree structure that parsers can model unambiguously. Two roots would describe two separate trees in one file.
Do comments or the declaration count as extra roots?
No. The XML declaration, comments, and processing instructions in the prolog are not elements, so they do not count toward the single-root rule. Only one actual element may appear at the top level of the document.
How do I combine several records into valid XML?
Wrap them in one parent element, for example put each <user> inside a single <users> root. Choose a container name that describes the collection, then nest every top-level item inside it so the document has exactly one root.

Check Your XML Now

Our XML validator detects this error automatically and shows the exact line and column.

Open XML Validator

Related XML Errors

Unclosed Tag in XML

Fix the XML unclosed tag error fast. Learn why every opening tag needs a matching closing tag or a self-closing form, with clear examples you can copy.

Mismatched Tags in XML

XML tag names are case-sensitive. Learn how to fix mismatched opening and closing tags, spot nesting mistakes, and make your XML well-formed once more.

Invalid or Missing XML Declaration

Learn how to write a correct XML declaration and fix common mistakes like wrong attribute order, missing encoding, or stray whitespace before the prolog.

View all XML errors