> [!NOTE] > **Note:** This entity is the same for all feed types. > [!IMPORTANT] > **Important:** Review the 'Named Entity Changes' [guide](https://developers.google.com/civics-data/guides/named-entity-changes) before modifying person names or managing duplicate records. Use the `Person` entity to define information about a person. The person might be a candidate, election official, or authority for a reporting unit. The [`ElectionReport`](https://developers.google.com/civics-data/reference/election-report) element includes `PersonCollection`, which contains the full set of `Person` objects in this feed. These `Person` objects are referenced in [`Candidate`](https://developers.google.com/civics-data/reference/candidate) and [`GpUnit`](https://developers.google.com/civics-data/reference/gp-unit). A `PersonCollection` optionally includes [`ContactInformation`](https://developers.google.com/civics-data/reference/contact-information) to associate contact information. ## Attributes The following table describes the attributes for the `Person` element: | Attribute | Required? | Type | Description | |---|---|---|---| | `objectId` | Required | `ID` | Unique internal identifier that's used by other elements to reference this element. | ## Elements The following table describes the elements for `Person`: | Element | Multiplicity | Type | Description | |---|---|---|---| | `Alias` | 0 or more | [`InternationalizedText`](https://developers.google.com/civics-data/reference/internationalized-text) | Other names this person goes by. | | `ContactInformation` | 0 or more | [`ContactInformation`](https://developers.google.com/civics-data/reference/contact-information) | Associates contact information with the person. This must include an [annotated URI](https://developers.google.com/civics-data/reference/uri-annotation) that's annotated with `wikipedia` and specifies the canonical Wikipedia page of the person, if one exists. Also provide any other known *personal* social media URIs or websites. This information must be for that person specifically, not their office or department. | | `DateOfBirth` | 0 or 1 | `PartialDate` | The person's date of birth. | | `ExternalIdentifiers` | 1 | [`ExternalIdentifiers`](https://developers.google.com/civics-data/reference/external-identifier) | Associates an ID with the person. A [stable identifier](https://developers.google.com/civics-data/guides/stable-identifiers) is required. | | `FirstName` | 0 or 1 | [`string`](https://developers.google.com/civics-data/reference/simple-data-types#xs-string) | The person's first (given) name. | | `FullName` | 1 | [`InternationalizedText`](https://developers.google.com/civics-data/reference/internationalized-text) | The person's full name. For details on how to handle full names in multiple languages, see [Local language content](https://developers.google.com/civics-data/guides/international-considerations#local-language-content). > [!WARNING] > **Warning:** `FullName` shouldn't contain the person's title. For example, '*King* Charles III' should be 'Charles III'. | | `Gender` | 0 or 1 | [`string`](https://developers.google.com/civics-data/reference/simple-data-types#xs-string) | The person's gender. The following values are available for `Gender`: - For men: `m`, `male`, or `man` - For women: `f`, `female`, or `woman` - For any other gender: `o`, `x`, `other`, or `nonbinary` | | `ImageUri` | 0 or more | [`AnnotatedUri`](https://developers.google.com/civics-data/reference/uri-annotation) | A URI that provides a direct link to an image of the person. The image must be licensed for use by third parties. > [!NOTE] > **Note:** For candidate headshot images, use the annotation `candidate-image`. Only one image annotated with this type is allowed per person. | | `LastName` | 0 or 1 | [`string`](https://developers.google.com/civics-data/reference/simple-data-types#xs-string) | The person's last (family) name. | | `MiddleName` | 0 or more | [`string`](https://developers.google.com/civics-data/reference/simple-data-types#xs-string) | The person's middle name. | | `Nickname` | 0 or 1 | [`string`](https://developers.google.com/civics-data/reference/simple-data-types#xs-string) | Nickname associated with the person if they have a commonly known alias. | | `PartyId` | 1 or more | `IDREF` | Unique identifier for a [`Party`](https://developers.google.com/civics-data/reference/party) element. Associates a political party with the person. Provide the `objectId` of the `Party` that this person is associated with. | | `Prefix` | 0 or 1 | [`string`](https://developers.google.com/civics-data/reference/simple-data-types#xs-string) | A prefix associated with the person such as *Mr.* or *Dr.* | | `Profession` | 0 or 1 | [`InternationalizedText`](https://developers.google.com/civics-data/reference/internationalized-text) | The person's profession. | | `Suffix` | 0 or 1 | [`string`](https://developers.google.com/civics-data/reference/simple-data-types#xs-string) | A suffix associated with the person such as *Jr.* | | `Title` | 0 or 1 | [`InternationalizedText`](https://developers.google.com/civics-data/reference/internationalized-text) | A title associated with the person. | ## Examples ### XML ```xml https://example.come/candidates/ayron-silva.jpg https://fb.com/ayronsilvasample/ https://www.instagram.com/ayron_silva_sample/ https://twitter.com/ayronsilvasample https://ayron-silva-sample.com/ https://www.youtube.com/user/ayron831/featured https://en.wikipedia.org/wiki/Ayron-Silva-Sample https://zh.wikipedia.org/zh/%E8%94%A1%E8%8B%B1%E6%96%87 https://ayronsilvacampaign.com other stable per-12321 Ayrton Silva Ayrton Silva एर्टन सेना アイルトン・シルバ 1960-01-01 M Silva par-dpp par-exp ```