Dtd Meaning & How to Use It

What Is a DTD?

A Document Type Definition (DTD) is a formal grammar that specifies which elements, attributes, and entities are allowed in an XML document, and in what order they may appear. It is one of the oldest validation methods for structured data, originating from the SGML standard in the 1980s and later adopted by XML 1.0 in 1998. DTDs are not written in XML syntax; they use a separate declaration syntax with keywords like ELEMENT, ATTLIST, and ENTITY.

In plain terms, a DTD acts like a blueprint. If you send an XML file to a business partner, a DTD tells both sides exactly what tags are expected, which attributes are required, and what values they can hold. Without it, two programs might interpret the same data differently.

Why Use a DTD?

Validation is the main reason. When an XML document is checked against a DTD, the parser can confirm that the structure is correct before the data is used in a database, a web service, or a configuration file. This catches errors early, such as a missing required element or an incorrect attribute value.

DTDs also enable data exchange between organizations. For example, an e-commerce company might publish a DTD that all suppliers must follow when sending product catalogs. That way, the receiving system knows exactly what to expect, even if each supplier writes the XML differently.

Another benefit is documentation. A well-written DTD serves as a human-readable specification of the data format, making it easier for new developers to understand what the XML should look like.

How a DTD Works

A DTD is declared either inside the XML document (internal) or in a separate file (external). The declaration appears in the DOCTYPE line at the top of the XML file.

Here is a simple internal DTD example:

<?xml version="1.0"?>
<!DOCTYPE note [
  <!ELEMENT note (to, from, heading, body)>
  <!ELEMENT to (#PCDATA)>
  <!ELEMENT from (#PCDATA)>
  <!ELEMENT heading (#PCDATA)>
  <!ELEMENT body (#PCDATA)>
]>
<note>
  <to>Tove</to>
  <from>Jani</from>
  <heading>Reminder</heading>
  <body>Don't forget the meeting</body>
</note>

The ELEMENT declarations define each tag. #PCDATA means parsed character data, i.e., plain text. The first line inside the DOCTYPE defines the root element and the order of its children. If the XML misses the to element or puts body before from, a validating parser will reject it.

External DTDs are more common for shared formats. The XML file references the DTD with a SYSTEM identifier:

<!DOCTYPE note SYSTEM "note.dtd">

This keeps the DTD separate so multiple XML documents can use the same rules.

Key Components of a DTD

There are four main types of declarations in a DTD:

Element declarations – define the name and content model of each tag. Content can be text, other elements, or a combination.
Attribute declarations – specify which attributes an element can have, whether they are required, and what values are allowed.
Entity declarations – define shortcuts for repeated text or special characters, like © for ©.
Notation declarations – identify external binary formats, like image files, that are referenced in the XML.

For example, an attribute declaration might look like:

<!ATTLIST note date CDATA #REQUIRED>

This forces every note element to have a date attribute with any text value.

How to Use a DTD in Practice

Using a DTD involves five steps:

Define the structure – List all elements and their relationships. Decide which are required, optional, or repeatable.
Write the DTD file – Create a text file with the .dtd extension and add the element, attribute, and entity declarations.
Reference the DTD – In your XML document, add the DOCTYPE declaration pointing to the DTD file, either internally or externally.
Validate the XML – Use an XML parser or an online validator to check that your XML conforms to the DTD. Most XML editors have a built-in validation feature.
Fix errors – If validation fails, read the error messages, correct the XML or the DTD, and revalidate until it passes.

Many free tools are available for validation, such as xmllint on Linux or the XML validator in Visual Studio Code. You can also test DTDs online on sites like W3Schools or CodeBeautify.

Common Problems and Misconceptions

One frequent issue is that DTDs are not namespace-aware. If your XML uses namespaces (like xmlns:xs), a DTD cannot fully validate the prefix usage. XML Schema (XSD) was created to solve this and other limitations.

Another problem is that DTDs do not support data types. Everything is treated as text, so you cannot specify that a value must be a number or a date. You can only define patterns for attributes using enumerated lists, but not for element content.

A common misconception is that DTDs are obsolete. While they are older than XSD and RELAX NG, they are still widely used in legacy systems, document formats like DocBook, and even in modern web technologies like SVG and MathML, which have their own DTDs.

Also, people often confuse DTD with DOCTYPE. The DOCTYPE is the declaration line in the XML that points to the DTD; the DTD itself is the set of rules. They are not the same thing.

DTD vs. XML Schema vs. RELAX NG

DTDs are not the only way to validate XML. Here is a quick comparison:

DTD – Simple, compact, and supports entities. But no data types, no namespaces, and uses a non-XML syntax.
XML Schema (XSD) – Written in XML, supports data types, namespaces, and more complex constraints. It is more verbose and harder to learn.
RELAX NG – Also XML-based, but simpler than XSD. It is easier to read and write, but less widely supported in older tools.

For new projects, XSD is often preferred because it is more powerful and integrates with modern web services. However, if you need a quick, human-readable validation rule set and do not require data types, a DTD is still a valid choice.

Frequently Asked Questions

What does DTD stand for?

DTD stands for Document Type Definition. It is a set of rules that defines the structure of an XML or SGML document.

Is DTD still used in 2025?

Yes, DTDs are still used in many legacy systems, document formats like DocBook, and some web standards. However, for new XML projects, XML Schema (XSD) is more common because it supports data types and namespaces.

What is the difference between DTD and XSD?

The main difference is that XSD is written in XML and supports data types, namespaces, and complex constraints, while DTD uses a custom syntax and treats all content as text. XSD is more powerful but more verbose.

Can I use a DTD with JSON?

No, DTD is specifically for XML and SGML documents. JSON has its own validation formats, like JSON Schema, which serve a similar purpose.

How do I create a DTD?

You create a DTD by writing a text file with element, attribute, and entity declarations, then referencing it from your XML document with a DOCTYPE declaration. You can use any text editor.

What happens if my XML does not match the DTD?

If you use a validating parser, it will report an error and refuse to process the XML. Non-validating parsers may ignore the DTD and process the XML anyway, which can lead to data corruption.

Sources: World Wide Web Consortium (W3C). Menus and buttons can differ slightly by version. Spotted something out of date? Tell us.