Attributes vs Child Elements — Design Decisions

One of the most common design debates in XML vocabulary design is whether a particular piece of data should be represented as an attribute of an element or as a child element. Both approaches are syntactically valid, but each has different implications for schema validation, querying, transformation, and readability. The general guidance is to use attributes for metadata — data that qualifies the element rather than being the element's primary content. Identifiers (id="b001"), categories (type="fiction"), and flags (available="true") are natural attributes. Use child elements for data that has its own structure, may repeat, could grow to contain sub-elements, or benefits from having attributes of its own. For example, an address is better as nested child elements than a single attribute value. There are also practical constraints. Attributes cannot contain child elements. Attributes cannot repeat on the same element. Attribute order is not significant and must not be relied upon. Attribute values are always plain text, so if you need typed or structured data, a child element validated by a schema is the better choice. XSLT and XPath treat attributes and elements differently, so downstream processing requirements should also inform the decision.

Example

<?xml version="1.0" encoding="UTF-8"?>
<catalog>

    <!--
        ATTRIBUTE-heavy style: metadata as attributes
        Good for: identifiers, flags, simple scalars
    -->
    <product id="p001" category="electronics" inStock="true" price="299.99">
        <name>Wireless Headphones</name>
    </product>

    <!--
        ELEMENT-heavy style: everything as child elements
        Good for: structured data, repeating data, data that may grow
    -->
    <product>
        <id>p002</id>
        <category>electronics</category>
        <inStock>true</inStock>
        <price currency="USD">149.99</price>
        <name>Bluetooth Speaker</name>
        <!-- address could not be a simple attribute value -->
        <manufacturer>
            <name>SoundCo</name>
            <country>USA</country>
        </manufacturer>
        <!-- Tags can repeat — impossible with attributes -->
        <tag>audio</tag>
        <tag>portable</tag>
        <tag>bluetooth</tag>
    </product>

</catalog>

HTML

Full Editor

Related Resources

XML Reference

Complete tag & property list

XML How-To Guides

Step-by-step practical guides

XML Exercises

Practice what you've learned