Structure types are listed in this section alphabetically by tag. When the same tag is used for different structure types in different contexts, they may be distinguished by their URI.
ABBR (Abbreviation) g7:ABBRA short name of a title, description, or name used for sorting, filing, and retrieving records.
ADDR (Address) g7:ADDRThe location of, or most relevant to, the subject of the superstructure. See ADDRESS_STRUCTURE for more details.
ADOP (Adoption) g7:ADOPAn Individual Event. See also INDIVIDUAL_EVENT_STRUCTURE.
ADOP (Adoption) g7:FAMC-ADOPAn enumerated value from set g7:enumset-ADOP indicating which parent(s) in the family adopted this individual.
ADR1 (Address Line 1) g7:ADR1The first line of the address, used for indexing. This structure’s payload should be a single line of text equal to the first line of the corresponding ADDR. See ADDRESS_STRUCTURE for more details.
ADR1 should not be added to new files; see ADDRESS_STRUCTURE for more details.
ADR2 (Address Line 2) g7:ADR2The second line of the address, used for indexing. This structure’s payload should be a single line of text equal to the second line of the corresponding ADDR. See ADDRESS_STRUCTURE for more details.
ADR2 should not be added to new files; see ADDRESS_STRUCTURE for more details.
ADR3 (Address Line 3) g7:ADR3The third line of the address, used for indexing. This structure’s payload should be a single line of text equal to the third line of the corresponding ADDR. See ADDRESS_STRUCTURE for more details.
ADR3 should not be added to new files; see ADDRESS_STRUCTURE for more details.
AGE (Age at event) g7:AGEThe age of the individual at the time an event occurred, or the age listed in the document.
AGNC (Responsible agency) g7:AGNCThe organization, institution, corporation, person, or other entity that has responsibility for the associated context. Examples are an employer of a person of an associated occupation, or a church that administered rites or events, or an organization responsible for creating or archiving records.
ALIA (Alias) g7:ALIAA single individual may have facts distributed across multiple individual records, connected by ALIA pointers (named after “alias” in the computing sense, not the pseudonym sense).
This specification does not define how to connect INDI records with ALIA. Some systems organize ALIA pointers to create a tree structure, with the root INDI record containing the composite view of all facts in the leaf INDI records. Others distribute events and attributes between INDI records mutually linked by symmetric pairs of ALIA pointers. A future version of this specification may adjust the definition of ALIA.
ANCI (Ancestor interest) g7:ANCIIndicates an interest in additional research for ancestors of this individual. (See also DESI).
ANUL (Annulment) g7:ANULA Family Event. See also FAMILY_EVENT_STRUCTURE.
ASSO (Associates) g7:ASSOA pointer to an associated individual. See ASSOCIATION_STRUCTURE for more details.
AUTH (Author) g7:AUTHThe person, agency, or entity who created the record. For a published work, this could be the author, compiler, transcriber, abstractor, or editor. For an unpublished source, this may be an individual, a government agency, church organization, or private organization.
BAPL (Baptism, Latter-Day Saint) g7:BAPLA Latter-Day Saint Ordinance. See also LDS_INDIVIDUAL_ORDINANCE.
BAPM (Baptism) g7:BAPMAn Individual Event. See also INDIVIDUAL_EVENT_STRUCTURE.
BARM (Bar Mitzvah) g7:BARMAn Individual Event. See also INDIVIDUAL_EVENT_STRUCTURE.
BASM (Bas Mitzvah) g7:BASMAn Individual Event. See also INDIVIDUAL_EVENT_STRUCTURE.
BIRT (Birth) g7:BIRTAn Individual Event. See also INDIVIDUAL_EVENT_STRUCTURE.
BLES (Blessing) g7:BLESAn Individual Event. See also INDIVIDUAL_EVENT_STRUCTURE.
BURI (Depositing remains) g7:BURIAn Individual Event. See also INDIVIDUAL_EVENT_STRUCTURE.
Although defined as any depositing of remains since it was introduced in the first version of GEDCOM, this tag is a shortened form of the English word “burial” and has been interpreted to mean “depositing of remains by burial” by some applications and users. In the absence of a clarifying TYPE substructure it is likely, but not guaranteed, that a BURI structure refers to a burial rather than another form of depositing remains.
CALN (Call number) g7:CALNAn identification or reference description used to file and retrieve items from the holdings of a repository. Despite the word “number” in the name, may contain any character, not just digits.
CAST (Caste) g7:CASTAn Individual Attribute. See also INDIVIDUAL_ATTRIBUTE_STRUCTURE.
CAUS (Cause) g7:CAUSThe reasons which precipitated an event. It is often used subordinate to a death event to show cause of death, such as might be listed on a death certificate.
CENS (Census) g7:FAM-CENSAn Family Event.
CENS (Census) g7:INDI-CENSAn Individual Event. See also INDIVIDUAL_EVENT_STRUCTURE.
CHAN (Change) g7:CHANThe most recent change to the superstructure. This is metadata about the structure itself, not data about its subject. See CHANGE_DATE for more details.
CHIL (Child) g7:CHILThe child in a family, whether biological, adopted, foster, sealed, or other relationship.
CHRA (Christening, adult) g7:CHRAAn Individual Event. See also INDIVIDUAL_EVENT_STRUCTURE.
CHR (Christening) g7:CHRAn Individual Event. See also INDIVIDUAL_EVENT_STRUCTURE.
CITY (City) g7:CITYThe name of the city used in the address. See ADDRESS_STRUCTURE for more details.
CONF (Confirmation) g7:CONFAn Individual Event. See also INDIVIDUAL_EVENT_STRUCTURE.
CONL (Confirmation, Latter-Day Saint) g7:CONLA Latter-Day Saint Ordinance. See also LDS_INDIVIDUAL_ORDINANCE.
CONT (Continued) g7:CONTA pseudo-structure to indicate a line break. The CONT tag is generated during serialization and is never present in parsed datasets. See Lines for more details.
COPR (Copyright) g7:COPRA copyright statement, as appropriate for the copyright laws applicable to this data.
CORP (Corporate name) g7:CORPThe name of the business, corporation, or person that produced or commissioned the product.
CREA (Creation) g7:CREAThe initial creation of the superstructure. This is metadata about the structure itself, not data about its subject. See CREATION_DATE for more details.
CREM (Cremation) g7:CREMAn Individual Event. See also INDIVIDUAL_EVENT_STRUCTURE.
CROP (Crop) g7:CROPA subregion of an image to display. It is only valid when the superstructure links to a MULTIMEDIA_RECORD with at least 1 FILE substructure that refers to an external file with a defined pixel unit.
LEFT and TOP indicate the top-left corner of the region to display. WIDTH and HEIGHT indicate how many pixels wide and tall the region to display is. If omitted, LEFT and TOP each default to 0; WIDTH defaults to the image width minus LEFT; and HEIGHT defaults to the image height minus TOP.
If the superstructure links to a MULTIMEDIA_RECORD that includes multiple FILE substructures, the CROP applies to the first FILE to which it can apply, namely the first external file with a defined pixel unit.
It is recommended that CROP be used only with a single-FILE MULTIMEDIA_RECORD.
The following are errors:
CTRY (Country) g7:CTRYThe name of the country that pertains to the associated address. See ADDRESS_STRUCTURE for more details.
DATA (Data) g7:DATAA structure with no payload used to distinguish a description of something from metadata about it. For example, SOUR and its other substructures describe a source itself, while SOUR.DATA describes the content of the source.
DATA (Data) g7:SOUR-DATASee g7:DATA.
DATA (Data) g7:HEAD-SOUR-DATAThe database, electronic data source, or digital repository from which this dataset was exported. The payload is the name of the database, electronic data source, or digital repository, with substructures providing additional details about it (not about the export).
DATE (Date) g7:DATEThe principal date of the subject of the superstructure. The payload is a DateValue.
When the superstructure is an event, the principal date indicates when the event took place.
When the superstructure is an attribute, the principal date indicates when the attribute was observed, asserted, or applied. A date period might put bounds on the attributes applicability, but other date forms assume that the attribute may have also applied on other dates too.
When the superstructure is a g7:SOUR-DATA, the principal date indicates when the data was entered into the source; or, for a source like a website that changes over time, a date on which the source contained the data.
See DATE_VALUE for more details.
DATE (Date) g7:DATE-exactThe principal date of the subject of the superstructure. The payload is a DateExact.
DATE (Date) g7:HEAD-DATEThe DateExact that this document was created.
DATE (Date) g7:NO-DATEThe DatePeriod during which the event did not occur or the attribute did not apply.
DATE (Date) g7:DATA-EVEN-DATEThe DatePeriod covered by the entire source; the period during which this source recorded events.
DEAT (Death) g7:DEATAn Individual Event. See also INDIVIDUAL_EVENT_STRUCTURE.
DESI (Descendant Interest) g7:DESIIndicates an interest in research to identify additional descendants of this individual. See also ANCI.
DEST (Destination) g7:DESTAn identifier for the system expected to receive this document. See HEAD.SOUR for guidance on choosing identifiers.
DIVF (Divorce filing) g7:DIVFA Family Event. See also FAMILY_EVENT_STRUCTURE.
DIV (Divorce) g7:DIVA Family Event. See also FAMILY_EVENT_STRUCTURE.
DSCR (Description) g7:DSCRAn Individual Attribute. See also INDIVIDUAL_ATTRIBUTE_STRUCTURE.
EDUC (Education) g7:EDUCAn Individual Attribute. See also INDIVIDUAL_ATTRIBUTE_STRUCTURE.
EMAIL (Email) g7:EMAILAn electronic mail address, as defined by any relevant standard such as RFC 3696, RFC 5321, or RFC 5322.
If an invalid email address is present upon import, it should be preserved as-is on export.
EMIG (Emigration) g7:EMIGAn Individual Event. See also INDIVIDUAL_EVENT_STRUCTURE.
ENDL (Endowment, Latter-Day Saint) g7:ENDLA Latter-Day Saint Ordinance. See also LDS_INDIVIDUAL_ORDINANCE.
ENGA (Engagement) g7:ENGAA Family Event. See also FAMILY_EVENT_STRUCTURE.
EVEN (Event) g7:FAM-EVENSee g7:INDI-EVEN.
EVEN (Event) g7:INDI-EVENAn event: a noteworthy happening related to an individual or family. If a specific event type exists, it should be used instead of a generic EVEN structure. Each EVEN must be classified by a subordinate use of the TYPE tag and may be further described in the structure’s payload.
EVEN (Event) g7:DATA-EVENA list of enumerated values from set g7:enumset-EVENATTR indicating the types of events that were recorded in a particular source. Each event type is separated by a comma and space. For example, a parish register of births, deaths, and marriages would be BIRT, DEAT, MARR.
EVEN (Event) g7:SOUR-EVENAn enumerated value from set g7:enumset-EVENATTR indicating the type of event or attribute which was responsible for the source entry being recorded. For example, if the entry was created to record a birth of a child, then the type would be BIRT regardless of the assertions made from that record, such as the mother’s name or mother’s birth date.
EXID (External Identifier) g7:EXIDAn identifier for the subject of the superstructure. The identifier is maintained by some external authority; the authority owning the identifier is provided in the TYPE substructure; see EXID.TYPE for more details.
Depending on the maintaining authority, an EXID may be a unique identifier for the subject, an identifier for 1 of several views of the subject, or an identifier for the externally-maintained copy of the same information as is contained in this structure. However, unlike UID and REFN, EXID does not identify a structure; structures with the same EXID may have originated independently rather than by edits from the same starting point.
EXID identifiers are expected to be unique. Once assigned, an EXID identifier should never be re-used for any other purpose.
FAM (Family record) g7:record-FAMSee FAMILY_RECORD
The common case is that each couple has one FAM record, but that is not always the case.
A couple that separates and then gets together again can be represented either as a single FAM with multiple events (MARR, DIV, etc.) or as a separate FAM for each time together. Some user interfaces may display these two in different ways and the two admit different semantics in sourcing. A single FAM with two MARR with distinct dates might also represent uncertainty about dates and a pair of FAM with same spouses might also be the result of merging multiple files.
Implementers should support both representations, and should choose between them based on user input or other context beyond that provided in the datasets themselves.
FACT (Fact) g7:FAM-FACTSee g7:INDI-FACT.
FACT (Fact) g7:INDI-FACTA noteworthy attribute or fact concerning an individual or family. If a specific attribute type exists, it should be used instead of a generic FACT structure. Each FACT must be classified by a subordinate use of the TYPE tag and may be further described in the structure’s payload.
If the attribute being defined was 1 of the person’s skills, such as woodworking, the FACT tag would have the value of “Woodworking”, followed by a subordinate TYPE tag with the value “Skills”.
FAMC (Family child) g7:INDI-FAMCThe family in which an individual appears as a child. It is also used with a g7:FAMC-STAT substructure to show individuals who are not children of the family. See FAMILY_RECORD for more details.
FAMC (Family child) g7:FAMCThe family with which this individual event is associated.
FAMC (Family child) g7:ADOP-FAMCThe individual or couple that adopted this individual.
Adoption by an individual, rather than a couple, may be represented either by pointing to a FAM where that individual is a HUSB or WIFE and using a g7:FAMC-ADOP substructure to indicate which 1 performed the adoption; or by using a FAM where the adopting individual is the only HUSB/WIFE.
FAMS (Family spouse) g7:FAMSThe family in which an individual appears as a partner. See FAMILY_RECORD for more details.
FAX (Facsimile) g7:FAXA fax telephone number appropriate for sending data facsimiles. See PHON for additional comments on telephone numbers.
FCOM (First communion) g7:FCOMAn Individual Event. See also INDIVIDUAL_EVENT_STRUCTURE.
FILE (File reference) g7:FILEA reference to an external file. See the File Path datatype for more details.
FORM (Format) g7:FORMThe media type of the file referenced by the superstructure.
FORM (Format) g7:PLAC-FORMA comma-separated list of jurisdictional titles, which has the same number of elements and in the same order as the PLAC structure. As with PLAC, this shall be ordered from lowest to highest jurisdiction.
FORM (Format) g7:HEAD-PLAC-FORMAny PLAC with no FORM shall be treated as if it has this FORM.
GEDC (GEDCOM) g7:GEDCA container for information about the entire document.
It is recommended that applications write GEDC with its required substructure g7:GEDC-VERS as the first substructure of HEAD.
GIVN (Given name) g7:GIVNA given or earned name used for official identification of a person.
GRAD (Graduation) g7:GRADAn Individual Event. See also INDIVIDUAL_EVENT_STRUCTURE.
HEAD (Header) g7:HEADA pseudo-structure for storing metadata about the document. See The Header and Trailer for more details.
HEIGHT (Height in pixels) g7:HEIGHTHow many pixels to display vertically for the image. See CROP for more details.
HUSB (Husband) g7:HUSBA container for information relevant to the subject of the superstructure specific to the individual described by the associated FAM’s HUSB substructure.
HUSB (Husband) g7:FAM-HUSBThis is a partner in a FAM record. See FAMILY_RECORD for more details.
IDNO (Identification number) g7:IDNOAn Individual Attribute. See also INDIVIDUAL_ATTRIBUTE_STRUCTURE.
IMMI (Immigration) g7:IMMIAn Individual Event. See also INDIVIDUAL_EVENT_STRUCTURE.
INDI (Individual) g7:record-INDISee INDIVIDUAL_RECORD.
INIL (Initiatory, Latter-Day Saint) g7:INILA Latter-Day Saint Ordinance. See also LDS_INDIVIDUAL_ORDINANCE. Previously, GEDCOM versions 3.0 through 5.3 called this WAC; it was not part of 5.4 through 5.5.1. FamilySearch GEDCOM 7.0 reintroduced it with the name INIL for consistency with BAPL, CONL, and ENDL.
LANG (Language) g7:LANGThe primary human language of the superstructure. The primary language in which the Text-typed payloads of the superstructure and its substructures appear.
The payload of the LANG structure is a language tag, as defined by BCP 47. A registry of component subtags is maintained publicly by the IANA.
In the absence of a LANG structure, the language is assumed to be unspecified; that may also be recorded explicitly with language tag und (meaning “undetermined”). See g7:HEAD-LANG for information about applying language-specific algorithms to text in an unspecified language.
If the text is primarily in one language with a few parts in a different language, it is recommended that a language tag identifying the primary language be used. If no one language is primary, the language tag mul (meaning “multiple”) may be used, but most language-specific algorithms will treat mul the same way they do und.
Conversations are ongoing about adding part-of-payload language tagging in a future version of the specification to provide more fidelity for multilingual text.
If the text is not in any human language and should not be treated as lingual content, the language tag zxx (meaning “no linguistic content” or “not applicable”) may be used. An example of zxx text might be a diagram approximated using characters for their shape, not their meaning.
This specification does not permit LANG in every place where human language text might appear. Conversations are ongoing about adding it in more places in a future version of the specification. Using the current specification, additional language tagging can be accomplished using a documented extension tag by including the following in the header:
and using the extension tag like so:
LANG (Language) g7:HEAD-LANGA default language which may be used to interpret any Text-typed payloads that lack a specific language tag from a g7:LANG structure. An application may choose to use a different default based on its knowledge of the language preferences of the user.
The payload of the LANG structure is a language tag, as defined by BCP 47.
Some algorithms on text are language-specific. Examples include sorting sequences, name comparison and phonetic name matching algorithms, spell-checking, computer-synthesized speech, Braille transcription, and language translation. When the language of the text is given through a g7:LANG, that should be used. When g7:LANG is not available, g7:HEAD-LANG provides the file creator’s suggested default language. For some language-specific algorithms, the user’s preferred language may be a more appropriate default than the file’s default language. User language preferences can be found in a variety of platform-specific places, such as the default language from operating system settings, user locales, Input Method Editors (IMEs), etc.
LANG (Language) g7:SUBM-LANGA language the subject of that record understands.
The payload of the LANG structure is a language tag, as defined by BCP 47.
LATI (Latitude) g7:LATIA latitudinal coordinate. The payload is either N (for a coordinate north of the equator) or S (for a coordinate south of the equator) followed by a decimal number of degrees. Minutes and seconds are not used and should be converted to fractional degrees prior to encoding.
18 degrees, 9 minutes, and 3.4 seconds North would be formatted as N18.150944.
LEFT (Left crop width) g7:LEFTLeft is a number of pixels to not display from the left side of the image. See CROP for more details.
LONG (Longitude) g7:LONGA longitudinal coordinate. The payload is either E (for a coordinate east of the prime meridian) or W (for a coordinate west of the prime meridian) followed by a decimal number of degrees. Minutes and seconds are not used and should be converted to fractional degrees prior to encoding.
168 degrees, 9 minutes, and 3.4 seconds East would be formatted as E168.150944.
MAP (Map) g7:MAPA representative point for a location, as defined by LATI and LONG substructures.
Note that MAP provides neither a notion of accuracy (for example, the MAP for a birth event may be some distance from the point where the birth occurred) nor a notion of region size (for example, the MAP for a place “Belarus” may be anywhere within that nation’s 200,000 square kilometer area).
MARB (Marriage banns) g7:MARBA Family Event. See also FAMILY_EVENT_STRUCTURE.
MARC (Marriage contract) g7:MARCA Family Event. See also FAMILY_EVENT_STRUCTURE.
MARL (Marriage license) g7:MARLA Family Event. See also FAMILY_EVENT_STRUCTURE.
MARR (Marriage) g7:MARRA Family Event. See also FAMILY_EVENT_STRUCTURE.
MARS (Marriage settlement) g7:MARSA Family Event. See also FAMILY_EVENT_STRUCTURE.
MEDI (Medium) g7:MEDIAn enumerated value from set g7:enumset-MEDI providing information about the media or the medium in which information is stored.
When MEDI is a substructure of a g7:CALN, it is recommended that its payload describes the medium directly found at that call number rather than a medium from which it was derived.
Consider an asset in a repository that is a digital scan of a book of compiled newspapers; for this asset, the CALN.MEDI is recommended to be ELECTRONIC rather than BOOK or NEWSPAPER.
When MEDI is a substructure of a g7:FORM, it is recommended that its payload describes the medium from which it was derived.
Consider a digital photo in a multimedia record; for this asset, the FORM.MEDI is recommended to be PHOTO rather than ELECTRONIC.
MIME (Media type) g7:MIMEIndicates the media type of the payload of the superstructure.
As of version 7.0, only 2 media types are supported by this structure:
text/plain shall be presented to the user as-is, preserving all spacing, line breaks, and so forth.
text/html uses HTML tags to provide presentation information. Applications should support at least the following:
p and br elements for paragraphing and line breaks.b, i, u, and s elements for bold, italic, underlined, and strike-through text (or corresponding display in other locales; see HTML §4.5 for more).sup and sub elements for super- and sub-script.&, < >. Note that "e; and ' are only needed in attributes. Other entities should be represented as their respective Unicode characters instead.Supporting more of HTML is encouraged. Unsupported tags should be ignored during display.
Applications are welcome to support more XML entities or HTML character references in their user interface. However, exporting must only use the core XML entities, translating any other entities into their corresponding Unicode characters.
Applications are welcome to support additional HTML elements, but they should ensure that content is meaningful if those extra elements are ignored and only their content text is displayed.
Media types are also used by external files, as described under FORM. External file media types are not limited to text/plain and text/html.
If needed, text/html can be converted to text/plain using the following steps:
<p…>, </p…>, and <br…> with a line break<…> tags< with < and > with >& with &NAME (Name) g7:NAMEThe name of the superstructure’s subject, represented as a simple string.
NAME (Name) g7:INDI-NAMEA PERSONAL_NAME_STRUCTURE with parts, translations, sources, and so forth.
NATI (Nationality) g7:NATIAn Individual Attribute. See also INDIVIDUAL_ATTRIBUTE_STRUCTURE.
NATU (Naturalization) g7:NATUAn Individual Event. See also INDIVIDUAL_EVENT_STRUCTURE.
NCHI (Number of children) g7:FAM-NCHIA Family Attribute. See also FAMILY_ATTRIBUTE_STRUCTURE.
NCHI (Number of children) g7:INDI-NCHIAn Individual Attribute. See also INDIVIDUAL_ATTRIBUTE_STRUCTURE.
NICK (Nickname) g7:NICKA descriptive or familiar name that is used instead of, or in addition to, one’s official or legal name.
The label “nickname” and description text of this structure were introduced with version 5.5 in 1996, but are understood differently by different users. Some use NICK only for names that would be inappropriate in formal settings. Some use it for pseudonyms regardless of where they are used. Some use it for any variant of a name that is not the one used on legal documents. Because all of these uses, and likely others as well, are common in existing data, no further clarification of the meaning of the NICK structure is possible without contradicting some existing data.
NMR (Number of marriages) g7:NMRAn Individual Attribute. See also INDIVIDUAL_ATTRIBUTE_STRUCTURE.
NO (Did not happen) g7:NOAn enumerated value from set g7:enumset-EVEN identifying an event type which did not occur to the superstructure’s subject. A specific payload NO XYZ should only appear where XYZ would be legal.
See NON_EVENT_STRUCTURE for more details.
NOTE (Note) g7:NOTEA NOTE_STRUCTURE, containing additional information provided by the submitter for understanding the enclosing data.
When a substructure of HEAD, it should describe the contents of the document in terms of “ancestors or descendants of” so that the person receiving the data knows what genealogical information the document contains.
NPFX (Name prefix) g7:NPFXText that appears on a name line before the given and surname parts of a name.
NSFX (Name suffix) g7:NSFXText which appears on a name line after or behind the given and surname parts of a name.
OBJE (Object) g7:OBJESee MULTIMEDIA_LINK.
OBJE (Object) g7:record-OBJESee MULTIMEDIA_RECORD.
OCCU (Occupation) g7:OCCUAn Individual Attribute. See also INDIVIDUAL_ATTRIBUTE_STRUCTURE.
ORDN (Ordination) g7:ORDNAn Individual Event. See also INDIVIDUAL_EVENT_STRUCTURE.
PAGE (Page) g7:PAGEA specific location within the information referenced. For a published work, this could include the volume of a multi-volume work and the page number or numbers. For a periodical, it could include volume, issue, and page numbers. For a newspaper, it could include a date, page number, and column number. For an unpublished source or microfilmed works, this could be a film or sheet number, page number, or frame number. A census record might have an enumerating district, page number, line number, dwelling number, and family number.
It is recommended that the data in this field be formatted comma-separated with label: value pairs
If the superstructure’s pointer is @VOID@ then there is no information referenced and the PAGE may describe the entire source.
PEDI (Pedigree) g7:PEDIAn enumerated value from set g7:enumset-PEDI indicating the type of child-to-family relationship represented by the superstructure.
PHON (Phone) g7:PHONA telephone number. Telephone numbers have many regional variations and can contain non-digit characters. Users should be encouraged to use internationalized telephone numbers rather than local versions. As a starting point for this recommendation, there are international standards that use a “‘+’” shorthand for the international prefix (for example, in place of “011” in the US or “00” in the UK). Examples are +1 (555) 555-1234 (US) or +44 20 1234 1234 (UK).
PHRASE (Phrase) g7:PHRASETextual information that cannot be expressed in the superstructure due to the limitations of its data type. A PHRASE may restate information contained in the superstructure, but doing so is not recommended unless it is needed for clarity.
A date interpreted from the phrase “The Feast of St John” might be
A record using 1648/9 to indicate a change in new year might become
A record using 1648/9 to indicate uncertainty in the year might become
A record using Q1 1867 to indicate an event occurred sometime within the first quarter of 1867 might become
A record defining the Maid of Honor in a marriage might become
PLAC (Place) g7:PLACThe principal place in which the superstructure’s subject occurred, represented as a List of jurisdictional entities in a sequence from the lowest to the highest jurisdiction, where “jurisdiction” includes units in a political, ecclesiastical, and geographical hierarchies and may include units of any size, such as a continent, “at sea”, or a specific building, farm, or cemetery. As with other lists, the jurisdictions are separated by commas. Any jurisdiction’s name that is missing is still accounted for by an empty string in the list.
The type of each jurisdiction is given in the PLAC.FORM substructure, if present, or in the HEAD.PLAC.FORM structure. If neither is present, the jurisdictional types are unspecified beyond the lowest-to-highest order noted above.
PLAC (Place) g7:HEAD-PLACThis is a placeholder for providing a default PLAC.FORM, and must not have a payload.
POST (Postal code) g7:POSTA code used by a postal service to identify an area to facilitate mail handling. See ADDRESS_STRUCTURE for more details.
PROB (Probate) g7:PROBAn Individual Event. See also INDIVIDUAL_EVENT_STRUCTURE.
PROP (Property) g7:PROPAn Individual Attribute. See also INDIVIDUAL_ATTRIBUTE_STRUCTURE.
PUBL (Publication) g7:PUBLWhen and where the record was created. For published works, this includes information such as the city of publication, name of the publisher, and year of publication.
For an unpublished work, it includes the date the record was created and the place where it was created, such as the county and state of residence of a person making a declaration for a pension or the city and state of residence of the writer of a letter.
QUAY (Quality of data) g7:QUAYAn enumerated value from set g7:enumset-QUAY indicating the credibility of a piece of information, based on its supporting evidence. Some systems use this feature to rank multiple conflicting opinions for display of most likely information first. It is not intended to eliminate the receivers’ need to evaluate the evidence for themselves.
REFN (Reference) g7:REFNA user-defined number or text that the submitter uses to identify the superstructure. For instance, it may be a record number within the submitter’s automated or manual system, or it may be a page and position number on a pedigree chart.
This is metadata about the structure itself, not data about its subject. Multiple structures describing different aspects of the same subject must not have the same REFN value.
RELI (Religion) g7:RELIA religious denomination associated with the event or attribute described by the superstructure.
RELI (Religion) g7:INDI-RELIAn Individual Attribute. See also INDIVIDUAL_ATTRIBUTE_STRUCTURE.
RESN (Restriction) g7:RESNA List of enumerated values from set g7:enumset-RESN signifying access to information may be denied or otherwise restricted.
The RESN structure is provided to assist software in filtering data that should not be exported or otherwise used in a particular context. It is recommended that tools provide an interface to allow users to filter data on export such that certain RESN structure payload entries result in the RESN structure and its superstructure being removed from the export. Such removal must abide by some constraints: see Removing data for more details.
This is metadata about the structure itself, not data about its subject.
REPO (Repository) g7:REPOREPO (Repository) g7:record-REPOSee REPOSITORY_RECORD.
RESI (Residence) g7:FAM-RESIA Family Attribute. See also FAMILY_ATTRIBUTE_STRUCTURE.
See g7:INDI-RESI for comments on the use of payload strings in RESI structures.
RESI (Residence) g7:INDI-RESIAn Individual Attribute. See also INDIVIDUAL_ATTRIBUTE_STRUCTURE.
Where possible, the residence should be identified in PLAC and/or ADDR substructures of the RESI structure. The payload text should not duplicate PLAC or ADDR information, but may be used for residence information that cannot be expressed by those structures.
The following two examples show situations where a RESI payload may be appropriate:
RETI (Retirement) g7:RETIAn Individual Event. See also INDIVIDUAL_EVENT_STRUCTURE.
ROLE (Role) g7:ROLEAn enumerated value from set g7:enumset-ROLE indicating what role this person played in an event or person’s life.
The following indicates a child’s birth record as the source of the mother’s name:
SCHMA (Extension schema) g7:SCHMAA container for storing meta-information about the extension tags used in this document. See Extensions for more details.
SDATE (Sort date) g7:SDATEA date to be used as a sorting hint. It is intended for use when the actual date is unknown, but the display order may be dependent on date.
If both a DATE and SDATE are present in the same structure, the SDATE should be used for sorting and positioning while the DATE should be displayed as the date of the structure.
SDATE and its substructures (including PHRASE, TIME, and any extension structures) should be used only as sorting hints, not to convey historical meaning.
It is recommended to use a payload that matches [[day D] month D] year [D epoch]. Other DateValue forms may have unreliable effects on sorting. Including a month and day is encouraged to help different applications sort dates the same way, as the relative ordering of dates with different levels of precision is not well defined.
SEX (Sex) g7:SEXAn enumerated value from set g7:enumset-SEX that indicates the sex of the individual at birth.
SLGC (Sealing, child) g7:SLGCA Latter-Day Saint Ordinance. See also LDS_INDIVIDUAL_ORDINANCE.
SLGS (Sealing, spouse) g7:SLGSA Latter-Day Saint Ordinance. See also LDS_SPOUSE_SEALING.
SNOTE (Shared note) g7:SNOTEA pointer to a note that is shared by multiple structures. See NOTE_STRUCTURE for more details.
SNOTE (Shared note) g7:record-SNOTEA note that is shared by multiple structures. See SHARED_NOTE_RECORD for more details.
SOUR (Source) g7:SOURA description of the relevant part of a source to support the superstructure’s data. See SOURCE_CITATION for more details.
SOUR (Source) g7:record-SOURA description of an entire source. See SOURCE_RECORD for more details.
SOUR (Source) g7:HEAD-SOURAn identifier for the product producing this dataset. A registration process for these identifiers existed for a time, but no longer does. If an existing identifier is known, it should be used. Otherwise, a URI owned by the product should be used instead.
SPFX (Surname prefix) g7:SPFXA name piece used as a non-indexing pre-part of a surname.
SSN (Social security number) g7:SSNAn Individual Attribute. See also INDIVIDUAL_ATTRIBUTE_STRUCTURE.
STAE (State) g7:STAEA geographical division of a larger jurisdictional area, such as a state within the United States of America. See ADDRESS_STRUCTURE for more details.
STAT (Status) g7:ord-STATAn enumerated value from set g7:enumset-ord-STAT assessing of the state or condition of an ordinance.
STAT (Status) g7:FAMC-STATAn enumerated value from set g7:enumset-FAMC-STAT assessing of the state or condition of a researcher’s belief in a family connection.
SUBM (Submitter) g7:SUBMA contributor of information in the substructure. This is metadata about the structure itself, not data about its subject.
SUBM (Submitter) g7:record-SUBMA description of a contributor of information to the document. See SUBMITTER_RECORD for more details.
SURN (Surname) g7:SURNA family name passed on or used by members of a family.
TAG (Extension tag) g7:TAGInformation relating to a single extension tag as used in this document. See Extensions for more details.
TEMP (Temple) g7:TEMPThe name of a temple of The Church of Jesus Christ of Latter-day Saints. Previous versions recommended using a set of abbreviations for temple names, but the list of abbreviations is no longer published by the Church and using abbreviations is no longer recommended.
TEXT (Text from Source) g7:TEXTA verbatim copy of any description contained within the source. This indicates notes or text that are actually contained in the source document, not the submitter’s opinion about the source. This should be, from the evidence point of view, “what the original record keeper said” as opposed to the researcher’s interpretation.
TIME (Time) g7:TIMEA Time value in a 24-hour clock format.
TITL (Title) g7:TITLThe title, formal or informal, of the superstructure.
A published work, such as a book, might have a title plus the title of the series of which the book is a part. A magazine article would have a title plus the title of the magazine that published the article.
For an unpublished work, including most digital files, titles should be descriptive and appropriate to the work.
TITL of a letter might include the date, the sender, and the receiver.TITL of a transaction between a buyer and seller might have their names and the transaction date.TITL of a family Bible containing genealogical information might have past and present owners and a physical description of the book.TITL of a personal interview would cite the informant and interviewer.Some sources may have a citation text that cannot readily be represented using the SOURCE_RECORD substructures AUTH, PUBL, REPO, and so on. In such cases, the entire citation text may be presented as the payload of the SOUR.TITL.
TITL (Title) g7:INDI-TITLAn Individual Attribute. See also INDIVIDUAL_ATTRIBUTE_STRUCTURE.
TOP (Top crop width) g7:TOPA number of pixels to not display from the top side of the image. See CROP for more details.
TRAN (Translation)A representation of the superstructure’s data in a different format.
In some situations it is desirable to provide the same semantic content in multiple formats. Where this is desirable, a TRAN substructure is used, where the specific format is given in its language tag substructure, media type substructure, or both.
Different TRAN structures are used in different contexts to fully capture the structure of the information being presented in multiple formats. In all cases, a TRAN structure’s payload and substructures should provide only information also contained in the TRAN structures’ superstructure, but provide it in a new language, script, or media type.
Each TRAN substructure must have either a language tag or a media type or both. Each TRAN structure must differ from its superstructure and from every other TRAN substructure of its superstructure in either its language tag or its media type or both.
TRAN (Translation) g7:NAME-TRANA type of TRAN substructure specific to Personal Names. Each NAME.TRAN must have a LANG substructure. See also INDI.NAME.
TRAN (Translation) g7:PLAC-TRANA type of TRAN substructure specific to places. Each PLAC.TRAN must have a LANG substructure. See also PLAC.
TRAN (Translation) g7:NOTE-TRANA type of TRAN for unstructured human-readable text, such as is found in NOTE and SNOTE payloads. Each g7:NOTE-TRAN must have either a LANG substructure or a MIME substructure or both. If either is missing, it is assumed to have the same value as the superstructure. See also NOTE and SNOTE.
The following presents the same note in HTML-format English; in plain-text with the same language as the superstructure (English); and in Spanish with the same media type as the superstructure (HTML).
It is recommended that text given in text/html should only be translated into text/plain if the resulting text is different from the text created by the HTML-to-text conversion process defined in g7:MIME.
TRAN (Translation) g7:FILE-TRANA type of TRAN for external media files. Each g7:NOTE-TRAN must have a FORM substructure. See also FILE and the File Path datatype.
If an mp3 audio file has been transcoded as an ogg file and a timestamped transcript has been extracted as a WebVTT file, the resulting set of files might be presented as follows:
Note that FILE.TRAN refers to translation to a different digital format, not to translation to a different human language. Files that differ in the human language of their content should each be given their own FILE structure.
TRLR (Trailer) g7:TRLRA pseudo-structure marking the end of a dataset. See The Header and Trailer for more details.
TYPE (Type) g7:TYPEA descriptive word or phrase used to further classify the superstructure.
When both a NOTE and free-text TYPE are permitted as substructures of the same structure, the displaying systems should always display the TYPE value when they display the data from the associated structure; NOTE will typically be visible only in a detailed view.
TYPE must be used whenever the generic EVEN, FACT and IDNO tags are used. It may also be used for any other event or attribute.
Using the subordinate TYPE classification method provides a further classification of the superstructure but does not change its basic meaning.
A ORDN with a TYPE could clarify what kind of ordination was performed:
This classifies the entry as an ordination as a bishop, which is still a ordination event. The event could be further clarified with RELI, DATE, and other substructures.
Other descriptor values might include, for example,
BIRT (birth)MARR (marriage)GRAD (graduation)WILLSee also FACT and EVEN for additional examples.
TYPE (Type) g7:NAME-TYPEAn enumerated value from set g7:enumset-NAME-TYPE indicating the type of the name.
TYPE (Type) g7:EXID-TYPEThe authority issuing the EXID, represented as a URI. It is recommended that this be a URL.
If the authority maintains stable URLs for each identifier it issues, it is recommended that the TYPE payload be selected such that appending the EXID payload to it yields that URL. However, this is not required and a different URI for the set of issued identifiers may be used instead.
Registered URIs are listed in the exid-types registry, where fields are defined using the YAML file format.
Additional type URIs can be registered by filing a GitHub pull request.
UID (Unique Identifier) g7:UIDA globally-unique identifier of the superstructure, to be preserved across edits. If a globally-unique identifier for the record already exists, it should be used without modification, not even whitespace or letter case normalization. New globally unique identifiers should be created and formatted as described in RFC 4122.
This is metadata about the structure itself, not data about its subject. Multiple structures describing different aspects of the same subject would have different UID values.
Because the UID identifies a structure, it can facilitate inter-tool collaboration by distinguishing between a structure being edited and a new structure being created. If an application allows structures to be edited in a way that completely changes their meaning (e.g., changing all the contents of an INDI record to have it describe a completely different person) then any UIDs should also be changed.
Some systems used a 16-byte UUID with a custom 2-byte checksum for a total of 18 bytes:
Use of checksums for UIDs is discouraged except in cases where error-prone input is expected and an appropriate action to take in case of an error is known.
VERS (Version) g7:VERSAn identifier that represents the version level assigned to the associated product. It is defined and changed by the creators of the product.
VERS (Version) g7:GEDC-VERSThe version number of the official specification that this document’s data conforms to. This must include the major and minor version (for example, “7.0”); it may include the patch as well (for example, “7.0.1”), but doing so is not required. See A Guide to Version Numbers for more details about version numbers.
WIDTH (Width in pixels) g7:WIDTHHow many pixels to display horizontally for the image. See CROP for more details.
WIFE (Wife) g7:WIFEA container for information relevant to the subject of the superstructure specific to the individual described by the associated FAM’s WIFE substructure.
WIFE (Wife) g7:FAM-WIFEA partner in a FAM record. See FAMILY_RECORD for more details.
WILL (Will) g7:WILLAn Individual Event. See also INDIVIDUAL_EVENT_STRUCTURE.
WWW (Web address) g7:WWWA URL or other locator for a World Wide Web page of the subject of the superstructure, as defined by any relevant standard such as whatwg/url, RFC 3986, RFC 3987, and so forth.
Like other substructures, the WWW structure provides details about the subject of its superstructure. For example, a MARR.WWW is a world wide web page of the marriage event, not the personal website of the couple or an entry in an online database serving as a source documenting the marriage. However, the meaning of WWW was only implicit when it was introduced in version 5.5.1 and many files were created that use WWW to store a more tangentially-related web address, so applications are recommended to interpret the WWW structure’s meaning cautiously.
If an invalid or no longer existing web address is present upon import, it should be preserved as-is on export.