🠕

3.4 Enumeration Values

Unless otherwise specified in the enumeration description in this section, each enumeration value defined in this section has a URI constructed by concatenating g7:enum- to the enumeration value; for example, the HUSB enumeration value has the URI http://gedcom.io/terms/v7/enum-HUSB.

Each set of enumeration values has its own URI.

g7:enumset-ADOP

ValueMeaning
HUSBAdopted by the HUSB of the FAM pointed to by FAMC.
The URI of this value is g7:enum-ADOP-HUSB
WIFEAdopted by the WIFE of the FAM pointed to by FAMC.
The URI of this value is g7:enum-ADOP-WIFE
BOTHAdopted by both HUSB and WIFE of the FAM pointed to by FAMC

g7:enumset-EVEN

An event-type tag name, but not the generic EVEN tag. See Events.

Most values in this enumeration set use the same tag and URI as the corresponding event, except for tags used with different URIs for FAM vs INDI; these are given generic definitions with URIs constructed by concatenating g7:enum- to the enumeration value:

ValueMeaning
CENSA census event; either g7:INDI-CENS or g7:FAM-CENS

g7:enumset-EVENATTR

An event- or attribute-type tag name. See Events and Attributes.

Most values in this enumeration set use the same tag and URI as the corresponding event or attribute, except for tags used with different URIs for FAM vs INDI; these are given generic definitions with URIs constructed by concatenating g7:enum- to the enumeration value:

ValueMeaning
CENSA census event; either g7:INDI-CENS or g7:FAM-CENS
NCHIA count of children; either g7:INDI-NCHI or g7:FAM-NCHI
RESIA residence attribute; either g7:INDI-RESI or g7:FAM-RESI
FACTA generic attribute; either g7:INDI-FACT or g7:FAM-FACT
EVENA generic event; either g7:INDI-EVEN or g7:FAM-EVEN

g7:enumset-MEDI

ValueMeaning
AUDIOAn audio recording
BOOKA bound book
CARDA card or file entry
ELECTRONICA digital artifact
FICHEMicrofiche
FILMMicrofilm
MAGAZINEPrinted periodical
MANUSCRIPTWritten pages
MAPCartographic map
NEWSPAPERPrinted newspaper
PHOTOPhotograph
TOMBSTONEBurial marker or related memorial
VIDEOMotion picture recording
OTHERA value not listed here; should have a PHRASE substructure

g7:enumset-PEDI

ValueMeaning
ADOPTEDAdoptive parents
BIRTHFamily structure at time of birth
FOSTERThe child was included in a foster or guardian family
SEALINGThe child was sealed to parents other than birth parents
OTHERA value not listed here; should have a PHRASE substructure

It is known that some users have interpreted BIRTH to mean “genetic parent” and others to mean “social parent at time of birth”. Definitions differ in many circumstances (infidelity, surrogacy, sperm donation, and so on). Hence, applications should refrain from asserting it has either meaning in imported data.

The structures for foster children in particular, and family relationships in general, are known to have undesirable limitations and are likely to change in a future version of this specification.

SEALING implies that a SLGC event was performed, and it is recommended that this enumeration value only be used when the SLGC event is present in the GEDCOM file. ADOPTED, on the other hand, only implies a social relationship which may or may not have any associated ADOP event.

g7:enumset-QUAY

ValueMeaning
0Unreliable evidence or estimated data
1Questionable reliability of evidence (interviews, census, oral genealogies, or potential for bias, such as an autobiography)
2Secondary evidence, data officially recorded sometime after the event
3Direct and primary evidence used, or by dominance of the evidence

Although the values look like integers, they do not have numeric meaning.

The structures for representing the strength of and confidence in various claims are known to be inadequate and are likely to change in a future version of this specification.

g7:enumset-RESN

ValueMeaning
CONFIDENTIALThis data was marked as confidential by the user.
LOCKEDSome systems may ignore changes to this data.
PRIVACYThis data is not to be shared outside of a trusted circle, generally because it contains information about living individuals. This definition is known to admit multiple interpretations, so use of the PRIVACY restriction notice is not recommended.

It is recommended that applications allow users to chose how CONFIDENTIAL and/or PRIVACY data is handled when interfacing with other users or applications, for example by allowing them to exclude such data when exporting.

When a List of RESN enumeration values are present, all apply.

The line 1 RESN CONFIDENTIAL, LOCKED means the superstructure’s data is both considered confidential and read-only.

Since RESN was introduced in version 5.5 the intent of the PRIVACY value has been interpreted differently by different applications. Known interpretations include

  • Some assign PRIVACY by algorithm or policy, unlike the user-assigned CONFIDENTIAL
  • Some use PRIVACY to mark records that have already had private data removed
  • Some use the English definitions of “privacy” and “confidential” to inform different restrictions for each

There may also be applications using PRIVACY with interpretations not listed above.

Because these different interpretations became widespread before they were identified, determining which one is meant generally requires knowledge of which application applied the PRIVACY restriction notice. It is anticipated that a future version will deprecate the PRIVACY option and introduce new values for each of its current use cases.

g7:enumset-ROLE

ValueMeaning
CHILChild
CLERGYReligious official in event; implies OFFICIATOR
FATHFather; implies PARENT
FRIENDFriend
GODPGodparent or related role in other religions
HUSBHusband; implies SPOU
MOTHMother; implies PARENT
MULTIPLEA sibling from the same pregnancy (twin, triplet, quadruplet, and so on). A PHRASE can be used to specify the kind of multiple birth.
NGHBRNeighbor
OFFICIATOROfficiator of the event
PARENTParent
SPOUSpouse
WIFEWife; implies SPOU
WITNWitness
OTHERA value not listed here; should have a PHRASE substructure

These should be interpreted in the context of the recorded event and its primary participants. For example, if you cite a child’s birth record as the source of the mother’s name, the value for this field is “MOTH.” If you describe the groom of a marriage, the role is “HUSB.”

g7:enumset-SEX

ValueMeaning
MMale
FFemale
XDoes not fit the typical definition of only Male or only Female
UCannot be determined from available sources

This can describe an individual’s reproductive or sexual anatomy at birth. Related concepts of gender identity or sexual preference are not currently given their own tag. Cultural or personal gender preference may be indicated using the FACT tag.

g7:enumset-FAMC-STAT

ValueMeaning
CHALLENGEDLinking this child to this family is suspect, but the linkage has been neither proven nor disproven.
DISPROVENThere has been a claim by some that this child belongs to this family, but the linkage has been disproven.
PROVENLinking this child to this family has been proven.

When these enumeration values were introduced in version 5.5.1 it was assumed, but never specified, that “proven” referred to the definition provided by the Board for Certification of Genealogists. Because that meaning was not specified and other definitions of “proven” exist, existing files might use these values in other ways.

The structures for representing the strength of and confidence in various claims are known to be inadequate and are likely to change in a future version of this specification.

g7:enumset-ord-STAT

These values were formerly used by The Church of Jesus Christ of Latter-day Saints for coordinating between temples and members. They are no longer used in that way, meaning their interpretation is subject to individual user interpretation

The definition of some of these values combined with the official policies of the church mean that some values only make sense under a subset of ordinance structures. These contexts are identified in the “applies to” column below, and it is recommended that applications follow those guidelines. These recommendations were not present when these enumeration values were first introduced in version 5.3 so uses that do not conform to the “applies to” guidelines may be encountered; if so, they should be treated by applications like any other user-specified but semantically-strange data.

The definition of some of these values combined with the official policies of the church and the move of the church away from using GEDCOM for handling ordinance requests make them redundant and/or no longer relevant. If so, that is indicated in the “status” column below. Like the “applies to” column, the “status” column is a recommendation, not a requirement, and applications should be prepared to encounter non-current values.

ValueApplies toMeaningStatus
BICSLGCBorn in the covenant, so child to parent sealing ordinance is not required.Current
CANCELEDSLGSCanceled and considered invalid.Current
CHILDAll but SLGCDied before 8 years old, so ordinances other than child to parent sealing are not required.Current
COMPLETEDAllCompleted, but the date is not known.Deprecated, use DATE BEF date instead. This status was defined for use with TempleReady which is no longer in use.
EXCLUDEDAllPatron excluded this ordinance from being cleared in this submission.Deprecated. This status was defined for use with TempleReady which is no longer in use.
DNSSLGC, SLGSThis ordinance is not authorized.Current
DNS_CANSLGSThis ordinance is not authorized, and the previous ordinance is cancelled.Current
INFANTAll but SLGCDied before less than 1 year old, baptism or endowment not required.Deprecated. Use CHILD instead.
PRE_1970AllOrdinance was likely completed because an ordinance for this person was converted from temple records of work completed before 1970.Deprecated. Use DATE BEF 1970 instead.
STILLBORNAllBorn dead, so no ordinances are required.Current
SUBMITTEDAllOrdinance was previously submitted.Deprecated. This status was defined for use with TempleReady which is no longer in use.
UNCLEAREDAllData for clearing the ordinance request was insufficient.Deprecated. This status was defined for use with TempleReady which is no longer in use.

g7:enumset-NAME-TYPE

ValueMeaning
AKAAlso known as, alias, etc.
BIRTHName given at or near birth.
IMMIGRANTName assumed at the time of immigration.
MAIDENMaiden name, name before first marriage.
MARRIEDMarried name, assumed as part of marriage.
PROFESSIONALName used professionally (pen, screen, stage name).
OTHERA value not listed here; should have a PHRASE substructure