• Documentation >
• Data Formats >
• Gedcomx

Gedcomx (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.

Namespace:	http://gedcomx.org/v1/
URI:	http://gedcomx.org/v1/Gedcomx
Extends:	HypermediaEnabledData

Properties

Name	Type	Description
lang	string	The language of this genealogical data set. See http://www.w3.org/International/articles/language-tags/. Note that some language-enabled elements MAY override the language.
attribution	Attribution	The attribution of this genealogical data.
person	list of Person	The persons included in this genealogical data set.
relationship	list of Relationship	The relationships included in this genealogical data set.
sourceDescription	list of SourceDescription	The descriptions of sources included in this genealogical data set.
agent	list of Agent	The agents included in this genealogical data set.
event	list of Event	The events included in this genealogical data set.
place	list of PlaceDescription	The places included in this genealogical data set.
document	list of Document	The documents included in this genealogical data set.
Properties inherited from HypermediaEnabledData
link	list of Link	The list of hypermedia links. Links are not specified by GEDCOM X core, but as extension elements by GEDCOM X RS.
Properties inherited from ExtensibleData
id	string	A local, context-specific id for the data.

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>