JSON to XML Conversion: A Complete Developer Guide

← Back to Blog

Converting JSON to XML is one of the most common data transformation tasks developers face — especially when integrating modern REST APIs with legacy enterprise systems that consume XML, or when preparing data for SOAP web services. While the concept seems straightforward, the conversion involves several important decisions that affect the structure and usability of the output XML.

Why Convert JSON to XML?

JSON is the dominant format for modern APIs, but XML remains essential in many enterprise, government, and financial contexts:

• SOAP web services — older enterprise APIs require XML payloads
• EDI and B2B integrations — financial and supply chain systems use XML
• Content management systems — some CMS platforms use XML for data exchange
• Legacy system migrations — transforming modern JSON data into XML for legacy consumers
• XML-based configuration — Spring, Maven, and Android use XML for configuration

The Core Mapping: JSON to XML

The fundamental mapping converts JSON objects to XML elements, with object keys becoming element tag names:

// JSON input
{
  "user": {
    "id": 1,
    "name": "Alice",
    "email": "alice@example.com",
    "active": true
  }
}

// XML output
<?xml version="1.0" encoding="UTF-8"?>
<user>
  <id>1</id>
  <name>Alice</name>
  <email>alice@example.com</email>
  <active>true</active>
</user>

Handling JSON Arrays

Arrays are the trickiest part of JSON-to-XML conversion because XML has no native array concept. The standard approach wraps each array item in a repeated element with the parent key name:

// JSON with array
{
  "library": {
    "book": [
      {"title": "Clean Code", "author": "Martin"},
      {"title": "The Pragmatic Programmer", "author": "Hunt"}
    ]
  }
}

// XML output — each book becomes a <book> element
<library>
  <book>
    <title>Clean Code</title>
    <author>Martin</author>
  </book>
  <book>
    <title>The Pragmatic Programmer</title>
    <author>Hunt</author>
  </book>
</library>

Arrays of Primitives

When an array contains primitive values (strings, numbers), each value becomes a text element:

// JSON
{"tags": ["javascript", "nodejs", "api"]}

// XML
<tags>
  <item>javascript</item>
  <item>nodejs</item>
  <item>api</item>
</tags>

JSON Attributes Convention

When converting XML to JSON, attributes are often prefixed with @ to distinguish them from child elements. When converting back from JSON to XML, DataConvertProTools respects this convention:

// JSON with @ prefix for attributes
{"user": {"@id": "1", "@role": "admin", "name": "Alice"}}

// XML output — @ keys become XML attributes
<user id="1" role="admin">
  <name>Alice</name>
</user>

Handling Special Characters

XML requires certain characters to be escaped as entities. Any JSON string values containing these characters must be escaped in the output XML:

• & → &
• < → <
• > → >
• " → " (in attribute values)

A good converter handles this automatically. Always validate the output XML after conversion to catch any escaping issues.

Root Element Requirements

XML requires exactly one root element. If your JSON has multiple top-level keys, they will be wrapped in a root element during conversion:

// JSON with multiple top-level keys
{"name": "Alice", "age": 30, "city": "London"}

// Wrapped in a root element
<root>
  <name>Alice</name>
  <age>30</age>
  <city>London</city>
</root>

Validating the Output XML

After converting JSON to XML, always validate the output. Common issues include element names that start with numbers (invalid in XML), names containing spaces, and special characters in text content that need escaping. Use the XML validator on DataConvertProTools to check the converted output and auto-fix any issues.

Convert JSON to XML Free Online

Use the JSON to XML converter on DataConvertProTools — paste your JSON, click Convert, and get well-formatted XML output in one second. The converter handles arrays, nested objects, attributes (via @ prefix), special character escaping, and XML declaration automatically. Runs entirely in your browser — your data stays private.

JSON to XML Conversion Tools in Code

For automated server-side conversion, all major languages have libraries:

• Python: xmltodict library converts between XML and Python dicts (JSON-compatible)
• Node.js: xml2js and fast-xml-parser both support bidirectional conversion
• Java: Jackson with the jackson-dataformat-xml module handles XML/JSON round-trips
• .NET: System.Text.Json combined with XDocument provides conversion utilities

For one-off conversions during development or debugging, the DataConvertProTools JSON to XML converter is faster than writing code. For production pipelines handling thousands of records, implement the conversion in your application using one of the libraries above.