• Documentation >
• Data Formats >
• GEDCOM X (XML)

GEDCOM X (XML)

The GEDCOM X data formats define the serialization formats of the GEDCOM X conceptual model. The canonical documentation is provided by the formal specification documents:

• The GEDCOM X Conceptual Model, Version 1.0
• The GEDCOM X JSON Format, Version 1.0
• The GEDCOM X XML Format, Version 1.0

This documentation is provided as a non-normative reference guide.

Data Types

Example

<gedcomx id="..." xml:lang="..." xmlns="http://gedcomx.org/v1/">
  <attribution id="...">
    <contributor resource="..." resourceId="..."/>
    <modified>...</modified>
    <changeMessage>...</changeMessage>
    <changeMessageResource>...</changeMessageResource>
    <creator resource="..." resourceId="..."/>
    <created>...</created>
    <extension1 xmlns="">...</extension1>
    <extension2 xmlns="">...</extension2>
  </attribution>
  <person extracted="..." private="...">
    <living>...</living>
    <gender type="..."/>
    <name type="...">
      <preferred>...</preferred>
      <date/>
      <nameForm/>
    </name>
    <fact type="...">
      <date/>
      <place/>
      <value>...</value>
      <qualifier/>
    </fact>
    <display>
      <ascendancyNumber>...</ascendancyNumber>
      <birthDate>...</birthDate>
      <birthPlace>...</birthPlace>
      <deathDate>...</deathDate>
      <deathPlace>...</deathPlace>
      <descendancyNumber>...</descendancyNumber>
      <familyAsChild/>
      <familyAsParent/>
      <gender>...</gender>
      <lifespan>...</lifespan>
      <marriageDate>...</marriageDate>
      <marriagePlace>...</marriagePlace>
      <name>...</name>
      <relationshipDescription>...</relationshipDescription>
      <role>...</role>
    </display>
    <evidence/>
    <media/>
    <identifier/>
  </person>
  <relationship extracted="..." type="...">
    <person1 resource="..." resourceId="..."/>
    <person2 resource="..." resourceId="..."/>
    <fact type="...">
      <date/>
      <place/>
      <value>...</value>
      <qualifier/>
    </fact>
    <evidence/>
    <media/>
    <identifier/>
  </relationship>
  <sourceDescription about="..." xml:lang="..." mediaType="..." resourceType="..." version="...">
    <citation xml:lang="...">
      <citationTemplate/>
      <field/>
      <value>...</value>
    </citation>
    <mediator resource="..." resourceId="..."/>
    <publisher resource="..." resourceId="..."/>
    <authors>...</authors>
    <source description="..." descriptionId="...">
      <attribution/>
      <qualifier/>
    </source>
    <analysis resource="..." resourceId="..."/>
    <componentOf description="..." descriptionId="...">
      <attribution/>
      <qualifier/>
    </componentOf>
    <title xml:lang="...">...</title>
    <note xml:lang="...">
      <subject>...</subject>
      <text>...</text>
      <attribution/>
    </note>
    <attribution>
      <contributor/>
      <modified>...</modified>
      <changeMessage>...</changeMessage>
      <changeMessageResource>...</changeMessageResource>
      <creator/>
      <created>...</created>
    </attribution>
    <identifier type="...">...</identifier>
    <rights>...</rights>
    <replacedBy>...</replacedBy>
    <replaces>...</replaces>
    <status>...</status>
    <link/>
  </sourceDescription>
  <agent>
    <account>
      <accountName>...</accountName>
      <serviceHomepage/>
    </account>
    <address>
      <city>...</city>
      <country>...</country>
      <postalCode>...</postalCode>
      <stateOrProvince>...</stateOrProvince>
      <street>...</street>
      <street2>...</street2>
      <street3>...</street3>
      <street4>...</street4>
      <street5>...</street5>
      <street6>...</street6>
      <value>...</value>
    </address>
    <email resource="..." resourceId="..."/>
    <homepage resource="..." resourceId="..."/>
    <identifier type="...">...</identifier>
    <name xml:lang="...">...</name>
    <openid resource="..." resourceId="..."/>
    <person resource="..." resourceId="..."/>
    <phone resource="..." resourceId="..."/>
    <link/>
  </agent>
  <event extracted="..." type="...">
    <date confidence="...">
      <original>...</original>
      <formal>...</formal>
      <normalized/>
    </date>
    <place confidence="..." description="...">
      <original>...</original>
      <normalized/>
    </place>
    <role type="...">
      <person/>
      <details>...</details>
    </role>
    <evidence/>
    <media/>
    <identifier/>
  </event>
  <place extracted="..." type="...">
    <name xml:lang="...">...</name>
    <temporalDescription confidence="...">
      <original>...</original>
      <formal>...</formal>
      <normalized/>
    </temporalDescription>
    <latitude>...</latitude>
    <longitude>...</longitude>
    <spatialDescription resource="..." resourceId="..."/>
    <place resource="..." resourceId="..."/>
    <jurisdiction resource="..." resourceId="..."/>
    <display>
      <fullName>...</fullName>
      <name>...</name>
      <type>...</type>
    </display>
    <evidence/>
    <media/>
    <identifier/>
  </place>
  <document confidence="..." extracted="..." xml:lang="..." sortKey="..." textType="..." type="...">
    <text>...</text>
    <attribution/>
    <source/>
    <analysis/>
    <note/>
  </document>
  <link accept="..." allow="..." count="..." href="..." hreflang="..." offset="..." rel="..." results="..." template="..." title="..." type="..."/>
  <extension1 xmlns="">...</extension1>
  <extension2 xmlns="">...</extension2>
</gedcomx>