Control the quality of your genealogy data

GEDCOM standard, structure of genealogy data. Data management and control.


The word Gedcom designates a genealogical data exchange format.

It was originally developed by the Mormon Church for religious reasons, then retrieved by genealogists to exchange genealogical data between people running their genealogy applications on incompatible computer systems.

So Gedcom is a kind of genealogical language. It is the most famous and used worldwide.

The word Gedcom, which is an acronym for Genealogical data communication, is spelled like an acronym: GEDCOM. By metonymic derivation, a Gedcom also designates a genealogy file in Gedcom format. The file you are working on within Ancestris is a Gedcom.

Since the mid-1990s, with the advent of the Internet and the proliferation of digital exchanges, the Gedcom specification has gradually become an essential standard for most genealogy software and sites worldwide.

However, while most of them can export in Gedcom format, some of them do not strictly respect the Gedcom format and make some adaptations by adding proprietary structures or using existing ones for different meanings. In some cases, proprietary data structures cannot be properly converted to the Gedcom format and some data might simply not be exported.

Ancestris is fully Gedcom compatible with Gedcom versions 5.5 and 5.5.1. As a user, you may safely rely on Ancestris to keep comprehensive genealogy files, without risk of data loss, and share or transmit them with anyone.

Characteristics of a Gedcom file

A Gedcom file is a text file, i.e. a file containing human readable lines of text, that can be opened and edited using any text editor, such as Notepad, Kate, Kwrite, Gedit, etc. Its extension name is "*.ged".

As a result, such a file can be used *as is* by any genealogy software, installed under any operating system, without any conversion need.

Each line of text starts with a number and a label. The label is called a "tag". This tag is made up of three or four capital letters. It defines the type of information that follows on the line.

Records of a Gedcom file

A Gedcom file contains a set of records. A record is a group of text lines, the first one of which starts with a zero "0". A record defines something in particular, which depends on the type of record.

The first and the last record of a Gedcom file are of particular types:

Each of the other records defines a genealogical entity, with its own set of tags.

A Gedcom file uses 7 entity categories. The records that can be found in a Gedcom file are therefore as follows:

The choice to consider these 7 categories of data as being records is arbitrary of course, but it is always the case when creating a standard.

One could easily imagine other types of records, such as places for example. The fact that a place is not a separate entity does not prevent Ancestris from managing them and respecting the Gedcom format at the same time.

Tree structure of a record

Each record is presented in a tree structure: each tag can include any number of sub-tags.

Sub-tags are hierarchically depending on the previous higher level tag, and may in turn include one or more sub-tags, etc.

Hierarchical levels

Hierarchical levels are numbered.

As each line must imperatively remain in its place from the point of view of the hierarchy, each of them is assigned a number corresponding to the level occupied in the tree structure of the record.

This is why the main level line of each record is level zero, numbered 0. A line located at the level immediately below bears the number 1. A line located at the level immediately below level 1 bears the number 2. And so on.

Identifier and entity records

As mentioned above, apart from HEAD and TRLR records, all the other records are entity records.

Each entity record starts with a level 0 line followed by the following:


For greater clarity, lines of a record can be indented so as to more clearly show the relationship between the lines of the record. The information lines underneath a tag qualify the tag.

0 @I5@ INDI 					=> this defines indidual number 'I5'
1 NAME John Doe 				=> The indivudual's name is John Doe
1 SEX M							=> This individual is a male
1 BIRT							=> What follows defines his birth event
2 DATE April 16, 1951			=> John Doe was therefore born on April 16, 1951
1 FAMC @F1328@					=> Family F1328 is the record that defines John Doe's family (FAM) where he is a child (C)
0 @I5@ INDI 					=> this defines indidual number 'I5'
	1 NAME John Doe 			=> The indivudual's name is John Doe
	1 SEX M						=> This individual is a male
	1 BIRT						=> What follows defines his birth event
		2 DATE April 16, 1951	=> John Doe was therefore born on April 16, 1951
	1 FAMC @F1328@				=> Family F1328 is the record that defines John Doe's family (FAM) where he is a child (C)

The Gedcom editor is an editor within Ancestris which shows you the exact information located in the Gedcom file and all of it. It also enhances the display of this information to make it even easier to read.

This editor uses an indented display and does not show level numbers. It also adds handles, to show or hide sub-tag levels, making it easy to expand or collapse any branch.


As you can see, the Gedcom editor enhances the display by adding icons and by fetching relevant hints.

In particular, the "@F1328@" piece of data is replaced, only in the display, not in the real Gedcom file, with the relevant information about the family. Here, we therefore immediately know that John's parents are named Martin and Kelly.

Also the name is split into its lastname and firstname parts.

Line formatting inside a record


Each line in a record is made of 3 elements:

Example: the line 2 DATE April 16, 1951 means level 2,  information of type DATE which value is 16 april 1951.

In order to know what this date refers to, you would have to read the previous lines. Knowing this is a level 2 line, there must be a level 1 (the event in this case) and a level 0 (the record entity) above.

Referencing another entity

Sometimes in a line, one may need to refer to another record entity. This is done using by indicating the identification number of the entity, surrounded by two at-signs (@).

The difference between reference "@id@" defining a record and reference "@id@" pointing to a record is the following:

Gedcom standard

The Gedcom standard refers to the set of rules that govern what can and cannot be done when writing a Gedcom file, so that everyone organizes genealogical information in the same, so that others can understand. It is therefore the grammar of the Gedcom language.

Two main standards exist, 5.5 and 5.5.1, the second being a slight evolution of the first one. Things permitted in the first are no longer permitted in the second, and vice versa. These differences are nevertheless limited.

Ancestris handles both 5.5 et 5.5.1. standards, and can convert your Gedcom file from one standard to the other and vice-versa.

Gedcom 5.5

This norm was released on January 2nd, 1996.

You will find details of the comprehensive Gedcom standard release 5.5 here in the form of an html site.

Gedcom 5.5.1

This norm was first released in 1999 as a draft and remained stable until November 15th, 2019 when it was made official.

You can also consult the Gedcom standard release 5.5.1 as a pdf file: Norme Gedcom 5.5.1.

These 20 years of stability makes this standard a very well documented and widely used way to exchange genealogical information.

Oddly enough, the two standards documentations are not available under the same format.

You will find in the 5.5.1 document a comparison between the two Gedcom standards.






An entity in the Gedcom standard is a main genealogical component such as an individual, a family, a source of information or a note. It can also be an multimedia object such as a video or a audio record.

In a Gedcom file, an entity is a record identified by an identification number and a group of tags specifying its characteristics.

The various genealogical characteristics associated with an entity are called properties: birth, marriage, date, place, event, text, address, etc.

Ancestris follows the Gedcom standard as closely as possible and uses the same concepts of entity and property.

The organization of information for each entity follows the precise grammar of the standard. This grammar provides several  possibilities to store the information. To see these various possibilities in Ancestris, use the Gedcom editor.


The 7 categories of entities

There are seven categories of entities in the Gedcom standard. An entity always belongs to one, and only one, of these seven categories.

Each category has its dedicated properties. However, regardless of the category to which they belong, all entities operate according to the same principles. There are described below.

In Ancestris, all entities are easily accessible from the Entity Table.



An individual, or a person, is a human being, living or deceased. It is the primary component of any genealogy.

In the Gedcom standard, an individual is defined by the INDI tag, and has an identification number which could nearly be anything. In Ancestris, this ID starts with the letter I.

Appearance in Ancestris : Ancestris_gedcom_tag_sexm.png Ancestris_gedcom_tag_sexf.png Ancestris gedcom tag sexin.png INDI Individual

The main properties of an individual are:

Events and relationships are probably the most interesting parts of your genealogy because they are the pieces of information that  will let you understand the life of your ancestors and the stories they could tell you.

Ancestris_gedcom_tag_name.png NAME : name of an individual. This tag can be repeated if the individual is known under several names.

Gedcom syntax:

NAME Lt. Cmndr. Joseph /Allen/ jr.

In this example jr. is considered the suffix of the name. All the information was entered only in the NAME tag without using any sub-tag.

The Gedcom standard provides a detailed structure to store the name of an individual, and specify all the possible elements of a name, in particular NICK and NSFX which are placed at the end of NAME.

Ancestris_gedcom_tag_name.png GIVN : (given name) First name. Its value must be identical to that in the NAME tag. It is an optional tag. The different first names are separated by a comma.
Ancestris_gedcom_tag_name.png NICK : (nick name) A familiar name or nickname, which is used in addition to, or instead of, the last name.
Ancestris_gedcom_tag_name.png NPFX : (name prefix) Name prefix. An element of the name that precedes the lastname (e.g. Master, General, Doctor, etc.)
Ancestris_gedcom_tag_name.png SPFX : (surname prefix) Particle before the Lastname. A complement to the name which is preceding the name, and which is not to be taken into account when sorting lastnames. Different articles / name prefixes are separated by a comma, for example in the name “de la Cruz”, this value must be “de, la”.
Ancestris_gedcom_tag_name.png SURN : (surname) Lastname at birth, family name. Different surnames are separated by a comma.
Ancestris_gedcom_tag_name.png NSFX : (name suffix) Lasname Suffix. A complement to the name, an article, which follows the last name, and which is not to be taken into account when sorting lastnames. Different name suffixes are separated by a comma. Example: eldest, son.
Ancestris_gedcom_tag_note.png NOTE : Note about the individual
Ancestris_gedcom_tag_sour.png SOUR : Source of information proving the existence and the characteristics of the individual.
Ancestris_gedcom_tag_sexin.png ALIA : (alias) Link with another individual entity, indicating that this current individual could be a duplicate of the other one and that one of the two should be removed eventually. It does mean that the two persons are the same person with a different name. One should use two NAME tags for that, within one single individual entity.



A family is a couple of human beings, living or deceased, united either by a legal union (e.g. marriage) or by a de-facto union (e.g. co-living). Most often, one or more children are associated with it.

A family is therefore a structure bringing together two or more individuals (spouse, children) as well as a set of specific properties such as the various events associated with it (marriage, divorce, etc.)

In the Gedcom standard, a family is designated by the FAM tag and receives an ID number starting with the letter F in Ancestris.

Appearance in Ancestris : Ancestris_gedcom_tag_fam.png FAM Family



A Media, or Multimedia Element is a photo, an audio or video document (a photograph, an audio recording, a film, a copy of a document, etc.) generally intended to be associated with one or more individuals or families or to be associated with a source.

In the Gedcom standard, a multimedia element is defined by the OBJE tag. It has an ID number starting with the letter M in Ancestris.

Appearance in Ancestris : Ancestris_gedcom_tag_obje.png OBJE multimedia element

Warning ! There are two kinds of multimedia elements: the entity and the property. These two kinds of media, although they have the same tag (OBJE), should not be confused.

In summary, if the same multimedia object must be assigned to several individuals, several families, etc., it is more efficient to store it in the form of a object entity. Once entered, it will be possible to use it an infinite number of times. As a object property, you would have to re-enter the link to the media file as many times as you would need it.

Warning ! Ancestris does not make any copy of your multimedia files. It just "refers" to the actual files. Ancestris will read them where you will need them in Ancestris. So please do not erase them thinking that Ancestris made a copy of them.



A note is a text information that can be associated with other categories of entities (individuals, families, multimedia elements, etc.) or with a property anywhere in the genealogy.

In the Gedcom standard, a note is defined by the tag NOTE and it has an ID number starting with the letter N in Ancestris.

Appearance in Ancestris : Ancestris_gedcom_tag_note.png NOTE Note

Warning ! There are two kinds of notes: the entity and the property. These two kinds of notes, although they have the same tag (NOTE), should not be confused.

In summary, if the same note must be assigned to several individuals, several families, etc., it is more efficient to store it in the form of a note entity. Once entered, it will be possible to use it an infinite number of times. As a note property, you would have to re-enter the text of the note as many times as you would need it.



A source is anything that defines the origin of a piece information. It can be a document, a book, a monument, etc.

It can also be a natural person: your great-grandmother can, for example, be qualified as a source, if she has transmitted a family history to you orally for instance.

This entity is intended to collect very precisely the various references (document title, symbol, act number, page, etc.) in order to allow any subsequent verification of the characteristics of other entities (in particular, individuals and families).

In the Gedcom standard, a source is defined by the SOUR tag and it has an ID number starting with the letter S in Ancestris.

Sources maintain a close relationship with other entities, repositories. A repository contains sources, and sources are located in repositories. Please refer to the following section for detailed considerations on how to organze sources and repositories.

Appearance in Ancestris : Ancestris_gedcom_tag_sour.png SOUR Source

Warning ! There are two kinds of sources: the entity and the property. These two kinds of sources, although they have the same tag (SOUR), should not be confused.

In summary, if the same source must qualify several events of individuals, families, etc., it is more efficient to store it in the form of a source entity. Once entered, it will be possible to use it an infinite number of times. As a source property, you would have to re-enter the characteristics of the source as many times as you would need it.



A submitter is a person who collects information to contribute to the construction of a genealogy file.

This person is likely to be one of the authors of the genealogy, or any genealogists likely to provide the Ancestris user with their genealogical information.

In the Gedcom standard, a submitter is defined by the SUBM tag and it has an ID number starting with the letter B in Ancestris.

Appearance in Ancestris : Ancestris_gedcom_tag_subm.png SUBM Submitter



A repository is a place where genealogy sources can be found (documents, books, audio recordings, films, etc.). It can be a physical building (e.g. archive, cemetery), or a website (e.g. the website of the archive service).

Repository entities maintain a close relationship with source entities. A repository is likely to contain several sources, a source belongs to a repository.

In the Gedcom standard, a repository is defined by the REPO tag and it has an ID number starting with the letter R in Ancestris.

Appearance in Ancestris : Ancestris_gedcom_tag_repo.png REPO Lieu de stockage


Header entity

The header entity is the first record of the Gedcom file. The header contains information about the file: version of the standard (5.5 or 5.5.1), the author of the file, structure of jurisdictions in places, etc.

Its creation is taken care of by Ancestris when creating a new file. You most probably will not need to change it after creation.

In Ancestris, it can be edited using the Menu > File > Properties. Refer to the File Properties page for more details.


Identification number of an entity

The ID number is an identification number assigned to each entity, within the same category. In order to avoid the creation of possible duplicates, this number is obviously unique.

Moreover, this particular number always has the same form, namely a letter followed by a certain number of digits. Each category of entity being associated with a particular letter, the first letter of the ID number indicates the category to which it belongs.

The user does not have to worry about assigning a new ID number when creating a new entity: this numbering is carried out automatically by Ancestris.

Note that in the Tools / Preferences / Editions / Identification number menu, a check box can be activated to reuse the ID numbers left available by entities that have been deleted.

Also, you can always change ID numbers later once entities have been created. Use the Generate ID Numbers tool for that.





A property if a piece of information describing a characteristic of an entity.

A property consists essentially of two elements: its name, identified by a TAG, and its VALUE.



Let's consider the following three properties.

These three properties share the same name (City), but have different values: London, Paris and Rome.

The City is coded in the Gedcom file by the tag CITY, in capital letters.



The Gedcom standard defines a large number of genealogical properties.

Each of these properties is identified by a Tag, which make each of them unique and unambiguous.

Here are some examples of properties and their tags between parenthesis.

For more details:



In the Gedcom file, properties always keep the same structure and follow strictly the same syntax rules.

In Ancestris, properties exactly correspond to the Gedcom properties, but they may look different depending on the view that displays them.

Properties in the Gedcom file

Each line of the Gedcom file is a property.

Each property line has the following format:

Number is the hierarchical level of the property as described in the Gedcom page.


2 DATE 27 SEP 1601

The first item is the number 2, indicating the level of the row in the record entity.

The second element is the DATE tag, indicating that the property is a date.

The third element is the value of the date (27 SEP 1601).

Therefore, the whole line means that the date of the genealogical element above this line, is September 27, 1601.

Properties in the Gedcom editor

The Gedcom editor displays property lines in a manner quite similar to that of the Gedcom file: one line per property, containing the tag followed by its value.

However, the following differences exist.

Properties in the other editors

In editors, properties are displayed in the user's language.

In the Aries and Cygnus editors, neither the labels, nor the lines, nor their tree structure appear: the name of each field, more explicit than a simple tag, simply invites the user to fill it in, as we fill in a form.

Properties in the Entities Table

In the Entity Table, each row represents an entity, and each column represents a property.

It is possible to configure the Table in order to choose the properties to display.

Properties displayed in windows

Other windows display properties, and allow them to be viewed, printed or edited (Navigator, Dynamic tree, etc.).






A tag is a property type identifyer.

The Gedcom standard defines a number of tags on three or four capital letters, taken from the English name of the property type.

For example, knowing that the SURN label means surname, the SURN Martin property line can be translated as: the surname is "Martin".

Ancestris assigns an icon to each property, just like with entities. For example, Ancestris adds TAG_Name.png to the NAME tag.

You will find in this page the list of most common tags.

The Gedcom editor is the Ancestris window that shows best all the properties in your genealogy.



The icon next to a tag helps you know whether the tag complies to the Gedcom standard or not.

Main predefined tags

All the Gedcom standards tags are managed by Ancestris: all the pre-defined Gedcom tags, all the user-defined tags(TAG_Attribute.png) that Ancestris has defined (e.g._SOSA), and all the user-defined tags you may have defined.

This first table is a description of the main tags.

  Tag name
Tag 5.5. 5.5.1. Description and usage
TAG_Note.png Abbreviation ABBR X X A short name of a title, description, or name.
TAG_Adoption.png Adoption ADOP X X Pertaining to creation of a legally approved child-parent relationship that does not exist biologically.
TAG_Addr.png Address ADDR X X The contemporary place, usually required for postal purposes, of an individual, a submitter of information, a repository, a business, a school, or a company.
TAG_Time.png Age AGE X X The age of the individual at the time an event occurred, or the age listed in the document.
TAG_Phone.png Agency AGNC X X The institution or individual having authority and/or responsibility to manage or govern.
TAG_Indi.png Alias ALIA X X An indicator to link different record descriptions of a person who may be the same person.
TAG_Annulment.png Annulment ANUL X X Declaring a marriage void from the beginning (never existed).
TAG_Association.png Associates ASSO X X An indicator to link friends, neighbours, relatives, or associates of an individual.
TAG_Note.png Attribute FACT
  X Attribute assigned to an individual
TAG_Note.png Author AUTH X X The name of the individual who created or compiled information.
TAG_MarriageBann.png Marriage Bann MARB X X An event of an official public notice given that two people intend to marry.
TAG_Baptism.png Christening CHR X X The religious event (not LDS) of baptising and/or naming a child.
TAG_Baptism.png Baptism BAPM X X The event of baptism (not LDS), performed in infancy or later.
TAG_Bar.png Bar Mitzvah BARM X X The ceremonial event held when a Jewish boy reaches age 13.
TAG_Bas.png Bas Mitzvah BASM X X The ceremonial event held when a Jewish girl reaches age 13, also known as "Bat Mitzvah."
TAG_Blessing.png Blessing BLES X X A religious event of bestowing divine care or intercession. Sometimes given in connection with a naming ceremony.
TAG_Attribute.png Map _MAP X   Anticipation of the 5.5.1 dstandard. Pertains to a representation of measurements usually presented in a graphical form.
TAG_Place.png Map MAP   X Pertains to a representation of measurements usually presented in a graphical form.
TAG_MarriageLicence.png Marriage license MARL X X An event of obtaining a legal license to marry.
TAG_Time.png Change CHAN X X Indicates a change, correction, or modification. Typically used in connection with a DATE to specify when a change in information occurred (it is automatically handled by Ancestris)
TAG_Code.png Postal code POST X X A code used by a postal service to identify an area to facilitate mail handling.
TAG_Type.png Status STAT X X An assessment of the state or condition of something.
TAG_Birth.png Confirmation CONF X X The religious event (not LDS) of conferring the gift of the Holy Ghost and, among protestants, full church membership.
TAG_MarriageContract.png Marriage contract MARC X X An event of recording a formal agreement of marriage, including the prenuptial agreement in which marriage partners reach agreement about the property rights of one or both, securing property to their
TAG_MarriageSettlement.png Marriage settlement MARS X X An event of creating an agreement between two people contemplating marriage, at which time they agree to release or modify property rights that would otherwise arise from the marriage.
TAG_Cremation.png Cremation CREM X X Disposal of the remains of a person's body by fire.
TAG_Attribute.png Daboville _DABOVILLE X X Special. It is not defined in the Gedcom format. It is used in Ancestris to generate the Daboville numbering for a descending genealogy.
TAG_Date.png Date DATE X X The time of an event in a calendar format.
hwFTAG_Death.png Death DEAT X X The event when mortal life terminates.
TAG_Graduation.png Graduation GRAD X X An event of awarding educational diplomas or degrees to individuals.
TAG_Divorce.png Divorce DIV X X An event of dissolving a marriage through civil action.
TAG_Attribute.png Data DATA X X Pertaining to stored automated information.
TAG_Attribute.png E-mail _EMAI X   Anticipation of the 5.5.1 standard. An electronic mail address.
TAG_Web.png E-mail EMAI   X Gedcom 5.5.1 only. An electronic mail address.
gGzTAG_Phone.png Fax FAX
  X Electronic facsimile transmission
TAG_Child.png Child CHIL X X The natural, adopted, or sealed (LDS) child of a father and a mother.
TAG_Media.png Multimedia element OBJE X X Pertaining to a grouping of attributes used in describing something. Usually referring to the data required to represent a multimedia object, such an audio recording, a photograph of a person, or an image of a document.
TAG_Emmigration.png Emigration EMIG X X An event of leaving one's homeland with the intent of residing elsewhere.
TAG_IndiFemale.png Wife WIFE X X An individual in the role as a mother and/or married woman.
TAG_Place.png State STAE X X A geographical division of a larger jurisdictional area, such as a State within the United States of



Event EVEN X X Pertaining to a noteworthy happening related to an individual, a group, or an organization. An EVENt structure is usually qualified or classified by a subordinate use of the TYPE tag.
TAG_Fam.png  Family FAM X X Identifies a legal, common law, or other customary relationship of man and woman and their children, if any, or a family created by virtue of the birth of a child to its biological father and mother.
TAG_Fam_link.png Family where person is a child FAMC X X Identifies the family in which an individual appears as a child.
TAG_Fam_link.png Family where person is a spouse FAMS X X Identifies the family in which an individual appears as a spouse.
TAG_Engagement.png Engagement ENGA X X An event of recording or announcing an agreement between two people to become married.
TAG_Disk.png File FILE X X An information storage place that is ordered and arranged for preservation and reference.
TAG_Format.png Format FORM X X An assigned name given to a consistent format in which information can be conveyed.
TAG_Submitter.png Submitter SUBM X X An individual or organization who contributes genealogical data to a file or transfers it to someone else.
TAG_Indi.png  Individual INDI X X A person.
TAG_Immigration.png Immigration IMMI X X An event of entering into a new locality with the intent of residing there.
TAG_Burial.png Burial BURI X X The event of the proper disposing of the mortal remains of a deceased person.
TAG_Submitter.png Ancestor interest ANCI X X Indicates an interest in additional research for ancestors of this individual.
TAG_Submitter.png Descendants interest DESI X X Indicates an interest in research to identify additional descendants of this individual.
TAG_Place.png Language LANG X X The name of the language used in a communication or transmission of information.
TAG_Attribute.png Latitude _LATI X  

Anticipation of the 5.5.1 standard. A value indicating a coordinate position on a line, plane, or space.

TAG_Place.png Latitude LATI   X A value indicating a coordinate position on a line, plane, or space.
TAG_Place.png Place PLAC X X A jurisdictional name to identify the place or location of an event.
TAG_Repository.png Repository REPO X X An institution or person that has the specified item as part of their collection(s).
TAG_Attribute.png Longitude _LONG X   Anticipation of the 5.5.1 standard. A value indicating a coordinate position on a line, plane, or space.
TAG_Place.png Longitude LONG   X A value indicating a coordinate position on a line, plane, or space.
TAG_IndiMale.png Husband HUSB X X An individual in the family role of a married man or father.
TAG_Marriage.png Marriage MARR X X A legal, common-law, or customary event of creating a family unit of a man and a woman as husband and wife.
TAG_Birth.png Birth BIRT X X The event of entering into life.
TAG_Nationality.png Nationality NATI X X The national heritage of an individual.
TAG_Naturalisation.png Naturalisation NATU X X The event of obtaining citizenship.
TAG_Education.png Education EDUC X X Indicator of a level of education attained.
TAG_Name.png Name NAME X X A word or combination of words used to help identify an individual, title, or other item. More than one NAME line should be used for people who were known by multiple names.
TAG_Name.png Surname SURN X X A family name passed on or used by members of a family.
TAG_NumChildren.png Number of children NCHI X X The number of children that this person is known to be the parent of (all marriages) when subordinate to an individual, or that belong to this family when subordinate to a FAM_RECORD.
TAG_Marriage.png Number of marriages NMR X X The number of times this person has participated in a family as a spouse or parent.
TAG_Note.png Note NOTE X X Additional information provided by the submitter for understanding the enclosing data.
TAG_IDNumber.png Identification number IDNO X X A number assigned to identify a person within some significant external system.
TAG_SSN.png Social security number SSN X X A number assigned by the United States Social Security Administration. Used for tax identification purposes.
TAG_Blob.png Binary object BLOB X   Set of data entered into a multimedia system that processes binary data to represent images, sound, video.
TAG_Ordination.png Ordination ORDN X X A religious event of receiving authority to act in religious matters.
TAG_Attribute.png Page PAGE X X A number or description to identify where information can be found in a referenced work.
TAG_Place.png Country CTRY X X The name or code of the country.
TAG_Format.png Pedigree PEDI X X Information pertaining to an individual to parent lineage chart.
TAG_Name.png Name prefix NPFX X X Text which appears on a name line before the given and surname parts of a name. i.e. (Lt. Cmndr.) Joseph /Allen/ jr.
In this example Lt. Cmndr. is considered as the name prefix portion.
TAG_Name.png Surname prefix SPFX X X A name piece used as a non-indexing pre-part of a surname.
TAG_Name.png Given name GIVN X X A given or earned name used for official identification of a person.
TAG_FirstCommunion.png First communion FCOM X X A religious rite, the first act of sharing in the Lord's supper as part of church worship..
TAG_Attribute.png Private _PRIV X X Special. It is not defined in the Gedcom format. It is used in Ancestris to mark individuals or events defined as private (private data in preferences tools).
TAG_Occupation.png Occupation OCCU X X The type of work or profession of an individual.
TAG_Note.png Publication PUBL X X Refers to when and/or where a work was published or created.
TAG_Blob.png Quality QUAY X X An assessment of the certainty of the evidence to support the conclusion drawn from evidence.
TAG_Cause.png Cause CAUS X X A description of the cause of the associated event or fact, such as the cause of death.
TAG_Census.png Census CENS X X The event of the periodic count of the population for a designated locality, such as a national or state Census.
TAG_Religion.png Religion RELI X X A religious denomination to which a person is affiliated or for which a record applies.
TAG_DivorceFiled.png Divorced filed DIVF X X An event of filing for a divorce by a spouse.
TAG_Retirement.png Retirement RETI X X An event of exiting an occupational relationship with an employer after a qualifying time period.
TAG_Code.png Reference REFN X X A description or number used to identify an item for filing, storage, or other reference purposes.
TAG_Type.png Relation RELA X X A relationship value between the indicated contexts.
TAG_Residency.png Residence RESI X X An address or place of residence that a family or individual resided.
TAG_Blob.png Role ROLE X X A name given to a role played by an individual in connection with an event.
TAG_Sex.png Sex SEX X X Indicates the sex of an individual--male or female or unknown.
TAG_Attribute.png Sosa _SOSA
X X Special. It is not defined in the Gedcom format. It is used in Ancestris to generate the Sosa or Sosa d'Aboville numbering for a person's ancestors and descendants.
TAG_Source.png Source SOUR X X The initial or original material from which information was obtained.
TAG_Name.png Name suffix NSFX X X Text which appears on a name line after or behind the given and surname parts of a name. i.e. Lt. Cmndr. Joseph /Allen/ (jr.)
In this example jr. is considered as the name suffix portion.
TAG_Name.png Nickname NICK X X A descriptive or familiar that is used instead of, or in addition to, one's proper name.
gGzTAG_Phone.png Phone PHON X X A unique number assigned to access a specific telephone.
TAG_Baptism.png Temple TEMP X X The name or code that represents the name of an LDS Church Temple.
TAG_Will.png Will WILL X X A legal document treated as an event, by which a person disposes of his or her estate, to take effect after death. The event date is the date the will was signed while the person was alive.
TAG_Note.png Text TEXT X X The exact wording found in an original source document.
TAG_Attribute.png Title TITL X X A description of a specific writing or other work, such as the title of a book when used in a source context, or a formal designation used by an individual in connection with positions of royalty or other social status, such as Grand Duke.
TAG_Type.png Type TYPE X X A further qualification to the meaning of the associated superior tag. The value does not have any computer processing reliability. It is more in the form of a short one or two word note that should be displayed any time the associated data is displayed.
TAG_Probate.png Probation PROB X X An event of judicial determination of the validity of a will. May indicate several related court activities over several dates.
TAG_Place.png City CITY X X A lower level jurisdictional unit. Normally an incorporated municipal unit.
TAG_Attribute.png Internet web site _WWW X   Anticipation of the 5.5.1 standard. World Wide Web home page.
TAG_Web.png Internet web site WWW   X World Wide Web home page.
TAG_Blob.png Local file _LOCAL
X X Calculated field indicating whether the media file is a file stored on disk (value 1) or an internet link (value 0). This field is not stored in Gedcom file and is read only.
TAG_Type.png Found file _FOUND
X X Calculated field indicating whether the media file exists (value 1) or not (value 0). This field is not stored in Gedcom file and is read only.

Other predefined tags

Many other tags can also be managed with Ancestris by adding them via the Gedcom Editor.

  Tag name
Tag 5.5. 5.5.1. Description and Usage
TAG_Addr.png Address1 ADR1 X X The first line of an address.
TAG_Addr.png Address2 ADR2 X X The second line of an address.
TAG_Addr.png Address3 ADR3   X The third line of an address.
TAG_Code.png Ancestral File Number AFN X X A unique permanent record file number of an individual record stored in Ancestral File.
TAG_Baptism.png Baptême LSD BAPL X X The event of baptism performed at age eight or later by priesthood authority of the LDS Church.
TAG_Attribute.png Call number CALN X X The number used by a repository to identify the specific items in its collections.
TAG_Confirmation.png Confirmation LDS CONL X X The religious event by which a person receives membership in the LDS Church.
TAG_Caste.png Caste CAST X X The name of an individual's rank or status in society which is sometimes based on racial or religious differences, or differences in wealth, inherited rank, profession, occupation, etc.
TAG_Baptism.png Adult christining CHRA X X The religious event (not LDS) of baptising and/or naming an adult person.
TAG_Description.png Physical description DSCR X X The physical characteristics of a person, place, or thing.
TAG_Baptism.png Endowment LDS ENDL X X A religious event where an endowment ordinance for an individual was performed by priesthood authority in an LDS temple.
TAG_Attribute.png Media MEDI X X Identifies information about the media or having to do with the medium in which information is stored.
TAG_Name.png Phonetic name FONE
  X Phonetic variation of the name
TAG_Name.png Romanized name ROMN
  X Romanized variation of the name
TAG_Property.png Property PROP X X Pertaining to possessions such as real estate or other property of interest.
TAG_Description.png Restriction RESN X X A processing indicator signifying access to information has been denied or otherwise restricted.
TAG_Code.png Record File Number RFN X X A permanent number assigned to a record that uniquely identifies it within a known file.
TAG_Blob.png Record Identification Number RIN X X A number assigned to a record by an originating automated system that can be used by a receiving system to report results pertaining to that record.
TAG_Baptism.png Sealing Child SLGC X X A religious event pertaining to the sealing of a child to his or her parents in an LDS temple ceremony.
TAG_Marriage.png Sealing Spouse SLGS X X A religious event pertaining to the sealing of a husband and wife in an LDS temple ceremony.

Accepted Tags

Gedcom tags not offered by the Gedcom editor but accepted by Ancestris are internal tags in the Gedcom file.

They are in the header of the file, except for HEAD and TRLR. They can be visible when opening your Gedcom file in a simple text editor.

  Tag name
Tag 5.5. 5.5.1. Description and Usage
TAG_Question.png Ancestors ANCE X X Pertaining to forbearers of an individual.
TAG_Question.png Character CHAR X X An indicator of the character set used in writing this automated information.
TAG_Question.png Concatenation CONC X X An indicator that additional data belongs to the superior value. The information from the CONC value is to be connected to the value of the superior preceding line without a space and without a carriage return and/or new line character. Values that are split for a CONC tag must always be split at a non-space. If the value is split on a space the space will be lost when concatenation takes place. This is because of the treatment that spaces get as a GEDCOM delimiter, many GEDCOM values are trimmed 85 of trailing spaces and some systems look for the first non-space starting after the tag to determine the beginning of the value (it is handle automatically by Ancestris)
TAG_Question.png Continuation CONT X X An indicator that additional data belongs to the superior value. The information from the CONT value is to be connected to the value of the superior preceding line with a carriage return and/or new line character. Leading spaces could be important to the formatting of the resultant text. When importing values from CONT lines the reader should assume only one delimiter character following the CONT tag. Assume that the rest of the leading spaces are to be a part of the value (it is handle automatically by Ancestris)
TAG_Question.png Copyright COPR X X A statement that accompanies data to protect it from unlawful duplication and distribution.
TAG_Question.png Corporate CORP X X A name of an institution, agency, corporation, or company.
TAG_Question.png Descent DESC X X Pertaining to offspring of an individual.
TAG_Question.png Destination DEST X X A system receiving data.
TAG_Question.png Family File FAMF X X Pertaining to, or the name of, a family file. Names stored in a file that are assigned to a family for doing temple ordinance work.
TAG_Question.png Information GEDC X X Information about the use of GEDCOM in a transmission.
TAG_Question.png Identification HEAD X X Identifies information pertaining to an entire GEDCOM transmission.
TAG_Question.png Legatee LEGA X   Person receiving a legacy or beneficiary of a testamentary clause.
TAG_Question.png Ordinance ORDI X X Pertaining to a religious ordinance in general.
TAG_Question.png Submission SUBN X X Pertains to a collection of data issued for processing.
TAG_Question.png Time TIME X X A time value in a 24-hour clock format, including hours, minutes, and optional seconds, separated by a colon (:). Fractions of seconds are shown in decimal notation.
TAG_Question.png Trailer TRLR X X At level 0, specifies the end of a GEDCOM transmission.
TAG_Question.png Version VERS X X Indicates which version of a product, item, or publication is being used or referenced.




An event is a notable fact in the life of an individual or a family, usually dated and localized.

While some events are necessarily unique (e.g. birth, death, burial), others may occur several times during a lifetime (e.g. marriage, occupation, residence, divorce).

The various types of events

Whether associated to an individual or a family, there are many different events.

A large number of events are predefined in the Gedcom standard and in Ancestris.

When a type of event has not been predefined, it is possible to choose the event "EVEN" which allows you to specify your own.


Predefined events for individuals


Predefined events for families


Event properties

An event is generally dated and localized. It can have other properties.

Here is a sample of them.





The date makes it possible to locate in time any genealogical event: birth, death, marriage, diploma, residence, etc.

In Ancestris, the date can be entered and displayed in different ways because it is set in a given calendar and can be more or less precise.


Enter dates

In Ancestris, date are entered using a specific widget, which is made up of two buttons, one for precision, the other one to specify the calendar, and the three components of a date (month, day and year). Examples :

Date_precise.png Date_period.png Date_Interpreted.png

Relative precision button

The Relative precision button unfolds a mini menu allowing you to indicate whether the date is precise or not, and in that second case, the range.



Calendar button

The Calendar type button opens a mini-menu allowing you to select one of the four calendars available to express the date. Here is an extract from Wikipedia.

When a date is currently entered, any change to the calendar type immediately converts that date to the newly selected calendar.

Please note the republican calendar only accepts conversion for dates between September 22, 1792 and December 31, 1805 as these are the main period during which this calendar was used.

In addition, following the name of the calendar, each line of the mini-menu displays the date currently entered, converted into this calendar, with the same exceptions as mentioned above concerning the line of the republican calendar.


Components of a date

The three constituents of a date - month, day and year - line up horizontally, always in the same order.


The different dates entered in Gedcom files are likely to be displayed in various reports, windows, and views.

The choice of how dates should be displayed is available in the panel Preferences / Data / General data.

Whatever format is adopted, the order of the three constituents of the date is always day month year in the Gedcom file.

In the Preferences, the Dates drop-down menu shows the following four display formats.


GEDCOM Format - 25 JAN 1970

The Gedcom format is the format used in the Gedcom file: the month is written in capitals, using the first three letters of the month in English. 

Short Format - 25 Jan 1970

The Short format displays the month in lowercase starting with a capital letter, written using the first three or four letters of the month in English.

Long Format - 25 January 1970

The Long format also displays the full month word in lowercase with a capital letter.

Number Format - 01/25/1970

The Numbers format displays month, day and year as numbers separated by a slashes (/).





A place is a property indicating a physical location associated with an event, and generally provided with a postal address and capable of receiving geographic coordinates (latitude and longitude).

In the Gedcom standard, a place is defined by the PLAC tag.

Place jurisdictions

The value of a place is presented as address elements separated by commas, such as a postal address.

Example (tag and value):

These elements of the place are called jurisdictions. A jurisdiction, also called a place criteria, is therefore a constitutive element of a place: the city, the postal code, the region, the country, etc.

In the example above, the jurisdictions are: neighborhood, postal code, city, county, state, region, country.

In the Gedcom standard, the different jurisdictions of a place are organized from left to right, separated by commas, and in increasing order of administrative importance.

The following example, which indicates the jurisdictions in random order, would not be compliant with the Gedcom standard.

The Gedcom standard allows you to define your own jurisdictions. We can indeed define the parish or neighbourhood level for example, or have two codes within the city: the ZIP or Postal code and the Census units.

How to use the comma

In the Gedcom standard, the comma is the separating element making it possible to distinguish the different jurisdictions of a place.

If one of the jurisdictions of a place is unknown, an empty space will be left to materialize this jurisdiction.

For example, in the absence of neighbourhood and ZIP code, the place of Boston mentioned above would take the following form:

The initial two successive commas indicate the locations of the two unspecified jurisdictions (neighbourhood and ZIP code).

For a good understanding when reading a place, it is therefore essential to respect the location of the commas, and obviously not to use a comma within a jurisdiction.

Please note that the Gedcom file does not accept any blanks on either side of these commas.

Place formatting

All places of the same genealogy must be described according to the same jurisdictions and in the same order.

This is the place format of the Gedcom file.

This format is indicated inside the Gedcom file, for all places in the genealogy, in the header of the Gedcom file.

These are the following lines of the header (HEAD) of the Gedcom file that will indicate this correspondence

This format is optional in the header but in terms of consistency and data quality we strongly recommend using it.

For a genealogy covering several countries, you therefore need a generic format that is extensive enough to allow the places of all the countries considered to be referenced under the same format.

Changing place formatting

The Modification of place criteria window allows to add or remove a type of jurisdiction in the format of the location, and also to modify the order of the different types of jurisdictions, for all locations and all the entities of the genealogy file. This window is accessible from the File / Properties menu.

Changing the format of places is also possible from the Gedcom editor: right-click on a PLAC line, then Context menu, then Set places criteria menu item.

To enter a location, you must rank the different jurisdictions in ascending order of importance, separating each level with a comma.

If a jurisdiction is not entered, the comma must be kept.

Entering a place


If in the Preferences you have chosen the presentation Split jurisdictions to edit in Gedcom editor, you do not have to worry about the explanations which follow, you will enter the jurisdictions separately, that is to say, level by level .

Otherwise, you must enter your locations globally, that is, as a serie of jurisdictions separated by commas.

For example, if the format is neighbourhood, postal code, city, county, state, region, country, for an event located at Hyde Park in Boston, ZIP Code 02136, state of Massachusetts, in the USA, you should enter:

The principle is easy:

Auto-completion of place jurisdictions

While entering a place name, a drop-down menu will open offering you already known places with the same string of characters inside the name. Just click the suggested line and press OK to select.

If you have chosen to display separate jurisdictions in the Preferences, this feature also exists, but line by line.

Change all places in one single change

If you notice that from the beginning, you made a typing error on a place, or if the same place was registered in different ways, you may want to make a change of all the erroneous places in one single change without having to go back in each of them to correct them.

This can be done using the Gedcom editor, or using the List of places or the Table of places.









Shared Information

Some pieces of information collated in a genealogy can either be specific to an individual, or shared by several individuals or several families of that genealogy.

A genealogy contains a lot of information, you will necessarily want to be able to reuse most of it.

If you want to reuse information, we strongly recommend that you initially store it in an entity rather than in a property.

This is the case for all Notes, all Sources, all Repositories, and all Multimedia Elements.

These Entities are defined here in the dedicated Entities.

Other information in Ancestris can be reused in a transparent way for you: these are places, occupations, types of events, diplomas, etc., and more generally all the short labels which describe events.


The principle, before creating any information in Ancestris, is to ask yourself whether this information is likely to be used again or not for other individuals.

Creation of shared information

If the information is likely to be reused:

  1. first create it as a new entity as such
  2. then link it from the other entity that will use it

In certain cases, the choice of shared information is obvious, such as repositories for instance.

In other cases, this choice is more subtle, such as Sources and Notes.

Entities using shared information

Another benefit of using shared entities is when you want to know all the entities in your genealogy that use a given information. You can know so by selecting the shared entity. The list of entities that use it appears in a list attached to this shared entity.

Conversely, it is a way to know if a shared entity is still being used at all.


Case of repositories

During your genealogical research, you will probably collect several documents originating from the same location.

To store all this information, you will create this location as a single repository, indicating its description, address, contact details, etc.

Then all the extracted documents will be your sources. Each of these sources will indicate the same repository.

This repository can also be a regional archive, a town hall, a website, a cemetery for instance.

Example of three sources from the same repository:


Case of a family certificate

If you discover a family certificate in which are indicated 3 children, and that in addition you write a note explaining your research story, you will have a diagram which could look like this:


The 3 individuals represent the siblings. Their births are sourced from the family certificate, which itself is sourced from a repository.

And your note comes in to support your research or observations about the 3 births.

You will notice in the diagram above that the source relates to the birth events of individuals, and not the individuals directly, which is more precise.

I assumed in the example that your note only spoke about the births of individuals. If it talked about their lives more broadly, you should probably link your note to the individuals rather than just to their birth.

Case of a note

A note is shared when it relates to several individuals at the same time. This was the case of the note in the previous example.

On the other hand, a note which comments on specific circumstances relating only to one single individual in particular should preferably be entered as an individual note and not generate the creation of a dedicated Note entity.

This is the case, for example, for details of a birth (the height and weight of the child, the fact that the person was born at his parents' home, etc.). These details will only ever relate to the birth of the individual considered and it is more efficient to enter this information directly at the birth level as an individual note.

Case of a place

The first time a place is created, it appears in the event where it is used first. Ancestris does not allow you to put it in a Place entity, even if you think you might need to reuse it later. This is because the Gedcom standard did not define places as entities.

This is not a problem, Ancestris manages the repository of places for you and considers that each place can be reused.

However, you must be careful when you create a place: it is up to you to check if it does not already exist, in order to avoid creating a duplicate. A duplicate on a place is not annoying as such, but it becomes so when, for example, you correct one of the two while thinking of correcting them all.

To avoid generating a duplicate when entering a place, Ancestris automatically suggests all the places found in your genealogy that include the text being entered.

Also, thanks to the List of places view, it is possible to merge places that have been entered twice by mistake.



The creation of Notes, Sources, Repositories, and Multimedia Elements is done either via the Context Menu of Ancestris, or via the menu bar, or automatically from the Cygnus editor or manually from the Aries editor.

The creation of places is done by entering a place directly in the editors, or in the Places editor.



To find out the list of entities using a particular Note, Source, Repository or Multimedia Element, all you have to do is select it from the table of entities for example, and view it in the Gedcom Editor.

You will then see all the entities using this information as linked properties.

Here is an example of source S5 that we have selected in the table of entities. If we look at the Gedcom Editor, we see the following:


This source S5 is used by four other entities of the genealogy: the note N2 on the assassination by Ravaillac, the name of the individual I29 Robert Capet, the death of Louis IX, and the name of Marguerite de Provence.

In the case of a Place, the easiest way to find out in which events it is used, is to go to the List of Places and select it. Events are listed by expanding the flap in the list. See the List of Places for more details.





There is an educational B-A-BA on shared information in PDF format. It is written in French.

It corresponds to version 9 of Ancestris but most of it is still relevant.

It tells you in detail how to create and use each of the shared entities presented above.

You can download it here.







Quality control

In order to be able to navigate your genealogy or in order to transmit this lifelong effort amount of information, it is necessary to remain consistent in the way you write similar types of information.

The Gedcom standard is a strong reference for this and suggests an extensive way to structure and specify your information.

Even staying within the standard, there are sometimes various possibilities to enter locations, notes, sources, events, media, etc. You may therefore want to control the quality of your data to make sure is it consistent.

We have identified several types of controls you can make:

Ancestris provides a way to know if the information entered is consistent with the standard, consistent with each other, or aligned with a format.

To identify most of the anomalies listed above, you may go to Menu / Tools /  Validate Gedcom compliance and data consistency.

To rectify places and multimedia elements, you have File / Properties.