| Filename extension | .ged |
|---|---|
| Internet media type | |
| Developed by | LDS FHD |
| Initial release | 1984; 41 years ago (1984) |
| Latest release | |
| Type of format | Genealogy data exchange |
| Standard | De facto[3] |
| Open format? | yes |
| Free format? | no[a] |
| Website | gedcom github |
FamilySearch GEDCOM, or simplyGEDCOM (/ˈdʒɛdkɒm/JED-kom,acronym ofGenealogical Data Communication), is anopen file format and thede facto standard specification for storinggenealogical data.[3] It was developed bythe Church of Jesus Christ of Latter-day Saints (LDS, also known as the Mormon Church), the operators ofFamilySearch, to aid in the research and sharing of genealogical information.[4] A common usage is as a standard format for the backup and transfer offamily tree data between differentgenealogy software andwebsites, most of which support importing from and exporting to GEDCOM format.[5]
GEDCOM is defined as aplain text file, usingUTF-8 encoding as of version 7.0. This file contains genealogical information about individuals such as names, events, and relationships;metadata links these records together.
GEDCOM 7.0, released in 2021, is the most recent version of the GEDCOM specification as of July 2024[update].[6] However, its predecessor, GEDCOM 5.5.1, remains the industry's format standard for the exchange of genealogical data.[citation needed] First released as a draft standard in 1999, GEDCOM 5.5.1 received only minor updates in the subsequent 20 years leading up to the release of 5.5.1 final in 2019. To address its shortcomings, some genealogy programs introducedproprietary extensions to GEDCOM which are not always recognized by other programs, such as GEDCOM 5.5 EL (Extended Locations).[7][8][9] Efforts have been made to have 7.0 more widely adopted since its release.FamilySearch intends to be GEDCOM 7.0 compatible in the third quarter 2022 andAncestry.com is planning for 7.0 compatibility, but has not yet specified an implementation date.[citation needed]
GEDCOM uses a lineage-linkeddata model based on theconceptual model of thenuclear family. The family (FAM) record type is therefore the only source of links between the individuals (INDI) in the file, assigning parents (asHUSB andWIFE) and children (asCHIL) by referring to individuals'unique ID numbers.[10] These historical origins are described in the 7.0 specification document: "TheFAM record was originally structured to represent families where a maleHUSB (husband or father) and femaleWIFE (wife or mother) produceCHIL (children)."[11]
Although the links in a GEDCOM family record still use the original naming indicating a husband and a wife, the specification now states that "sex, gender, titles, and roles of partners should not be inferred based on the partner that theHUSB orWIFE structure points to" and that these individuals within a family structure are collectively referred to as 'partners', 'parents' or 'spouses'. AFAM record can also be used for "cohabitation, fostering, adoption, and so on, regardless of the gender of the partners."[11]
A GEDCOM file consists of aheader section, records, and atrailer section. Within these sections,records represent people (INDI record), families (FAM records), sources of information (SOUR records), and other miscellaneous records, including notes. Every line of a GEDCOM file begins with a level number where all top-level records (HEAD, TRLR, SUBN, and each INDI, FAM, OBJE, NOTE, REPO, SOUR, and SUBM) begin with a line with level 0, while other level numbers are positiveintegers.
Although it is possible to write a GEDCOM file by hand, the format was designed to be used with software and thus is not especially human-friendly. A GEDCOM validator[12] that can be used to validate the structure of a GEDCOM file is included as part ofPhpGedView project, though it is not meant to be a standalone validator. For standalone validation "The Windows GEDCOM Validator" can be used.[13] or the older unmaintained Gedcheck[14] from the LDS Church.
During 2001,The GEDCOM TestBook Project evaluated how well four popular genealogy programs conformed to the GEDCOM 5.5 standard using the Gedcheck program.[15] Findings showed that a number of problems existed and that "The most commonly found fault leading to data loss was the failure to read the NOTE tag at all the possible levels at which it may appear."[16] In 2005, theGenealogical Software Report Card was evaluated (by Bill Mumford who participated in the originalGEDCOM Testbook Project)[17] and included testing the GEDCOM 5.5 standard using the Gedcheck program.[18]
To assist with adoption of GEDCOM 7.0, validation tools now exist for that standard as well.[19]
The following is a sample GEDCOM file.
| sample.ged |
0 HEAD1 SOUR PAF2 NAME Personal Ancestral File2 VERS 5.01 DATE 30 NOV 20001 GEDC2 VERS 5.52 FORM LINEAGE-LINKED1 CHAR ANSEL1 SUBM @U1@0 @I1@ INDI1 NAME John /Smith/1 SEX M1 FAMS @F1@0 @I2@ INDI1 NAME Elizabeth /Stansfield/1 SEX F1 FAMS @F1@0 @I3@ INDI1 NAME James /Smith/1 SEX M1 FAMC @F1@0 @F1@ FAM1 HUSB @I1@1 WIFE @I2@1 MARR1 CHIL @I3@0 @U1@ SUBM1 NAME Submitter0 TRLR |
The header (HEAD) includes the source program and version (Personal Ancestral File, 5.0), the GEDCOM version (5.5), thecharacter encoding (ANSEL), and a link to information about the submitter of the file.
The individual records (INDI) define John Smith (ID I1), Elizabeth Stansfield (ID I2), and James Smith (ID I3).
The family record (FAM) links the husband (HUSB), wife (WIFE), and child (CHIL) by their ID numbers.
The current version of the specification in wide use is GEDCOM5.5.1 final, which was released on 15 November 2019. Its predecessor, GEDCOM5.5.1 draft[20] was issued in 1999, introducing nine new attribute, tags and addingUTF-8 as an approvedcharacter encoding. The draft was not formally approved, but its provisions were adopted in some part by a number of genealogy programs[21][22][23] including FamilySearch.org.[20]
Lineage-linked GEDCOM is the deliberate de facto common denominator.[3] Despite version 5.5 of the GEDCOM standard first being published in 1996, many genealogical software suppliers have never fully supported the feature of multilingual Unicode text (instead of the ANSEL character set) introduced with that version of the specification. Uniform use of Unicode would allow for the usage of international character sets. An example is the storage of East Asian names in their originalChinese, Japanese and Korean (CJK) characters, without which they could be ambiguous and of little use for genealogical or historical research.[24]PAF 5.2 is an example of software that usesUTF-8 as its internal character set, and can output a UTF-8 GEDCOM.[24][25]
GEDCOM 7.0requires UTF-8 encoding throughout,[26] and resolves other long-standing issues with GEDCOM 5.5.1. Multimedia support in the form of an associated .zip file, called a GEDZip, is another inclusion. Efforts are underway to see 7.0 embraced as the new exchange standard.[27] GEDCOM 7.0 allows explicitly identifying what standards other than GEDCOM may apply to a particular file. GEDCOM has always beenextensible, but prior to 7.0 there was no standard way to identify such extensions. Also, GEDCOM 7.0 allows explicitly marking an event as nonexistent. This allows, for example, documenting that a particular individual never married.[28] GEDCOM 7.0 was the first version to usesemantic versioning, and is the most recentminor version of the specification.
As of July 2024[update], the next planned minor release is v7.1, which is under development.[29]
| GEDCOM version | Release date | Notes |
|---|---|---|
| Old version, not maintained: 1.0[30] | 1984[31] | – |
| Old version, not maintained: 2.0[30] | Dec 1985[32] | PAF 2.0 |
| Old version, not maintained: 2.1 | Feb 1987[32] | GEDCOM for PAF 2.1 |
| Old version, not maintained: 2.3 Draft | 7 August 1985[33] | with PAF2.0 GEDCOM implementation conventions |
| Old version, not maintained: 2.4 Draft | 13 December 1985[33] | with PAF2.0 GEDCOM implementation conventions |
| Old version, not maintained: 3.0 Standard[30] | 9 October 1987[34] | PAF 2.0 and 2.1 implementation of 3.0 |
| Old version, not maintained: 4.0 Standard | August 1989 | PAF 2.1 – 2.31 |
| Old version, not maintained: 4.1 Draft[35] | – | – |
| Old version, not maintained: 4.2 Draft[36] | 25 January 1990[37] | – |
| Old version, not maintained: 5.0 Draft[30] | 31 December 1991[33] | lineage-linked structures were introduced.[38] |
| Old version, not maintained: 5.1 Draft | 18 September 1992[32] | – |
| Old version, not maintained: 5.2 Draft | 22 January 1992[39] | – |
| Old version, not maintained: 5.3 Draft | 4 November 1993[40] | Unicode standard (ISO/IEC 10646) was introduced as an additional character set. |
| Old version, not maintained: 5.4 Draft | 21 August 1995[41] | – |
| Old version, not maintained: 5.5 Standard | 11 December 1995[42] | PAF 3, 4 and 5 |
| Old version, still maintained:5.5 Standard | January 2, 1996[43][44] | PAF 3, 4 and 5 /5.5 Standard[45] |
| Old version, not maintained: GEDCOM (Future Direction) Draft[38][46] | May 1, 1998[47][48] | "it used an entirely new data model"[49] |
| Old version, not maintained: 5.5.1 Draft[50][51] | October 2, 1999[20] | Used by FamilySearch.org[20]UTF-8 added as an approved character encoding. |
| Old version, still maintained: 5.5.1 Release[52] | November 15, 2019 | current standard, minor text modifications to 5.5.1 Draft. |
| Old version, not maintained: 5.6 Private Draft | -[53] | "Jed Allen sent those two files to a few people only for sort of "private comments"[54] |
| Old version, not maintained: 6.0 XML Draft | December 28, 2001[55] | Was not a complete specification, and not recommended to begin to software implementations. |
| Old version, not maintained: 7.0.0-rc1 Draft | February 2021[56] | Release candidate revealed for RootsTech 2021, but then all talks, specifications and the web site were removed on 25 February 2021[57] |
| Old version, not maintained: 7.0[58] | 27 May 2021 | Modernize character encoding, clarify ambiguities in 5.5.1 specification, introduce semantic versioning, improve multimedia handling |
| Latest version:7.0.13[59] | 4 August 2023 | |
Legend: Old version, not maintained Old version, still maintained Latest version Latest preview version Future version | ||
 | This sectiondoes notcite anysources. Please helpimprove this section byadding citations to reliable sources. Unsourced material may be challenged andremoved.(February 2009) (Learn how and when to remove this message) |
 | This article needs to beupdated. The reason given is: This section needs to be checked against GEDCOM 7.0 for accuracy, and sourced if still true.. Please help update this article to reflect recent events or newly available information.(July 2022) |
A GEDCOM file can contain information on events such as births, deaths, census records, ship's records, marriages, etc.; a rule of thumb is that an event is something that took place at a specific time, at a specific place (even if time and place are not known). GEDCOM files can also contain attributes such as physical description, occupation, and total number of children; unlike events, attributes generally cannot be associated with a specific time or place.
The GEDCOM specification requires that each event or attribute is associated with exactly one individual or family.[60] This causes redundancy for events such as census records where the actual census entry often contains information on multiple individuals. In the GEDCOM file, for census records a separate census "CENS" event must be added for each individual referenced. Some genealogy programs, such asGramps andThe Master Genealogist, have elaborate database structures for sources that are used, among other things, to represent multi-person events. When databases are exported from one of these programs to GEDCOM, these database structures cannot be represented in GEDCOM due to this limitation, with the result that the event or source information including all of the relevant citation reference information must be duplicated each place that it is used. This duplication makes it difficult for the user to maintain the information related to sources.
In the GEDCOM specification, events that are associated with a family such as marriage information is only stored in a GEDCOM once, as part of the family (FAM) record, and then both spouses are linked to that single family record.[60]
The GEDCOM specification was made purposefully flexible to support many ways of encoding data, particularly in the area of sources. This flexibility has led to a great deal of ambiguity, and has produced the side effect that some genealogy programs which import GEDCOM do not import all of the data from a file.[61]
The GEDCOM specification does not offer explicit support for keeping a known order of events. In particular, the order of relationships (FAMS) for a person and the order of the children within a relationship (FAM) can be lost. In many cases the sequence of events can be derived from the associated dates. But dates are not always known, in particular when dealing with data from centuries ago. For example, in the case that a person has had two relationships, both with unknown dates, but from descriptions it is known that the second one is indeed the second one. The order in which these FAMS are recorded in GEDCOM's INDI record will depend on the exporting program. In Aldfaer[62] for instance, the sequence depends on the ordering of the data by the user (alphabetical, chronological, reference, etc.). The proposed XML GEDCOM standard[55] does not address this issue either.
GEDCOM has many features that are not commonly used. Some software packages do not support all the features that the GEDCOM standard allows.
The GEDCOM standard supports the inclusion of multimedia objects (for example, photos of individuals).[63] Such multimedia objects can be either included in the GEDCOM file itself (called the "embedded form") or in an external file where the name of the external file is specified in the GEDCOM file (called the "linked form"). Embedding multimedia directly in the GEDCOM file makes transmission of data easier, in that all of the information (including the multimedia data) is in one file, but the resulting file can be enormous. Linking multimedia keeps the size of the GEDCOM file under control, but then when transmitting the file, the multimedia objects must either be transmitted separately or archived together with the GEDCOM into one larger file. Support for embedding media directly was dropped in the draft 5.5.1 standard.[64]
The GEDCOM standard allows for the specification of multiple opinions or conflicting data, simply by specifying multiple records of the same type. For example, if an individual's birth date was recorded as 10 January 1800 on the birth certificate, but 11 January 1800 on the death certificate, two BIRT records for that individual would be included, the first with the 10 January 1800 date and giving the birth certificate as the source, and the second with the 11 January 1800 date and giving the death certificate as the source. The preferred record is usually listed first.
This example encoded in GEDCOM might look like this:
0 @I1@ INDI1 NAME John /Doe/1 BIRT2 DATE 10 JAN 18002 SOUR @S1@3 DATA4 TEXT Transcription from birth certificate would go here3 NOTE This birth record is preferred because it comes from the birth certificate3 QUAY 21 BIRT2 DATE 11 JAN 18002 SOUR @S2@3 DATA4 TEXT Transcription from death certificate would go here3 QUAY 2
Conflicting data may also be the result of user errors. The standard does not specify in any way that thecontents must be consistent. A birth date like "10 APR 1819" might mistakenly have been recorded as "10 APR 1918" long after the person's death. The only way to reveal such inconsistencies is by rigorous validation of thecontent data.
The GEDCOM standard supports internationalization in several ways. First, newer versions of the standard allow data to be stored in Unicode (or, more recently, UTF-8), so text in any language can be stored.[65] Secondly, in the same way that one can have multiple events on a person, GEDCOM allows one to have multiple names for a person,[66] so names can be stored in multiple languages, although there is no standardized way to indicate which instance is in which language. Finally, in version 5.5.1, the NAME field also supports a phonetic variation (FONE) and a romanized variation (ROMN) of the name.[67]
In February 2012 at the RootsTech 2012 conference,FamilySearch outlined a major new project around genealogical standards called GEDCOM X, and invited collaboration.[68] It includes software developed under theApacheopen source license. It includes data formats that facilitate basing family trees on sources and records (both physical artifacts and digital artifacts), support for sharing and linking data online, and an API.[68][69][70]
In August 2012FamilySearch employee and GEDCOM X project leader Ryan Heaton dropped the claim that GEDCOM X is the new industry standard, and repositioned GEDCOM X as another FamilySearchopen source project.[71]
After the release of GEDCOM 7, FamilySearch positioned GEDCOM X as useful for interoperation with its FamilySearch Family Tree software.[72]
Commsoft, the authors of theRoots[73] series of genealogy software and Ultimate Family Tree, defined a version called Event-Oriented GEDCOM (also known as "Event GEDCOM" and originally called InterGED[74]),[75] which included events as first class (zero-level) items. Although it is event based, it is still a model built on assumed reality rather than evidence. Event GEDCOM was more flexible, as it allowed some separation between believed events and the participants. However, Event GEDCOM was not widely adopted by other developers due to its semantic differences.[citation needed] With Roots and Ultimate Family Tree no longer available, very few people today are using Event GEDCOM.[76]
Gramps XML is anXML-basedopen format created by theopen source genealogy projectGramps and used also byPhpGedView.
The Family History Information Standards Organisation was established in 2012 with the aim of developing international standards for family history and genealogical information.[77] One of the standards the organization proposed was Extended Legacy Format (ELF), compatible with GEDCOM 5.5(.1), but including an extensibility mechanism. The organization requested public comment on the proposed standard in 2017.[78] It withdrew the proposal because release 7.0 of GEDCOM addressed many of the organization's concerns.[28]