Facts are a combination of events and attributes, such as physical description and ethnicity. Facts may have a date, a place, and a value. Some facts may exist multiple times, while others are restricted to just one. The table at the end of this document lists the supported fact types and the different rules which apply to them.

When a fact only supports one conclusion, any attempts to create a second conclusion of the same type will be treated as an update to the existing value. For example, if we tried to create a person with two birth facts, the second birth fact would be treated as an update to the first.

Custom fact types can be created using the data URI scheme as specified by RFC 2397. Examples:

  • data:, Job
  • data:,Military%20Award

The following table lists the supported fact types and the different attributes which they support. Notice that FamilySearch only supports a subset of GEDCOM X conclusion types as well as a few FamilySearch specific types.

TypeScopeDatePlaceValueMultipleDeletableRestrictions
http://gedcomx.org/BarMitzvahpersonXXX
http://gedcomx.org/BatMitzvahpersonXXX
http://gedcomx.org/BirthpersonXXXone of date, place required
http://gedcomx.org/BurialpersonXXXone of date, place required
http://gedcomx.org/CastepersonXXXvalue is required
http://gedcomx.org/ChristeningpersonXXXone of date, place required
http://gedcomx.org/ClanpersonXXXvalue is required
http://gedcomx.org/CremationpersonXXX
http://gedcomx.org/DeathpersonXX
http://gedcomx.org/EthnicitypersonXXXvalue is required
http://gedcomx.org/ImmigrationpersonXXXXXone of date, place, value required
http://gedcomx.org/MilitaryServicepersonXXXXXone of date, place, value required
http://gedcomx.org/NationalIdpersonXXXvalue is required
http://gedcomx.org/NationalitypersonXXvalue is required
http://gedcomx.org/NaturalizationpersonXXXXXone of date, place, value required
http://gedcomx.org/OccupationpersonXXXXXvalue is required
http://gedcomx.org/PhysicalDescriptionpersonXXvalue is required
http://gedcomx.org/ReligionpersonXXXXXvalue is required
http://gedcomx.org/ResidencepersonXXXXXone of place, value required
http://gedcomx.org/StillbirthpersonXXX
http://familysearch.org/v1/AffiliationpersonXXXXXvalue is required
http://familysearch.org/v1/DiedBeforeEightpersonX
http://familysearch.org/v1/LifeSketchpersonXXvalue is required
http://familysearch.org/v1/NoChildrenpersonX
http://familysearch.org/v1/NoCoupleRelationshipspersonX
http://familysearch.org/v1/TitleOfNobilitypersonXXXXXvalue is required
http://familysearch.org/v1/TribeNamepersonXXXvalue is required
http://gedcomx.org/Annulmentcouple relationshipXXXX
http://gedcomx.org/CommonLawMarriagecouple relationshipXXXX
http://gedcomx.org/Divorcecouple relationshipXXXX
http://gedcomx.org/Marriagecouple relationshipXXXX
http://familysearch.org/v1/CoupleNeverHadChildrencouple relationshipX
http://familysearch.org/v1/LivedTogethercouple relationshipX
http://gedcomx.org/AdoptiveParentparent-child relationshipX
http://gedcomx.org/BiologicalParentparent-child relationshipX
http://gedcomx.org/FosterParentparent-child relationshipX
http://gedcomx.org/GuardianParentparent-child relationshipX
http://gedcomx.org/StepParentparent-child relationshipX