Revision history
Stay organized with collections
Save and categorize content based on your preferences.
Changes to the CDF documentation are listed here.
August 5, 2025
- Update
Feed documentation and Validator support for FeedType of
voter-information.
July 23, 2025
- Add additional values to
VoterInformationWebsiteType.
July 11, 2025
- Added
RetentionContest to the available Contest
types.
July 7, 2025
- Updated Metadata
Feed documentation and validator to clarify canceled
election events don't need to be considered when determining a Feed inactive
date.
June 25, 2025
- Added
whatsapp as a platform for AnnotatedUri.
June 16, 2025
- Updated Voter Information documentation for
VoterInformationWebsite and
ElectoralCommissionWebsite to reflect definitions in the CDF schema.
May 29, 2025
- Replaced
NoSourceDirPathBeforeInitialDeliveryDate validator rule with
SourceDirPathMustBeSetAfterInitialDeliveryDate.
May 27, 2025
- Added Validator support and basic checks for Voter information feeds.
May 22, 2025
- Published a guide to aid in determining
officeholder term dates.
May 13, 2025
May 7, 2025
May 6, 2025
- Update
PersonHasOffice rule to check new OfficeHolderTenure schema.
April 18, 2025
- Added clarification that
FullName elements of
People shouldn't contain the
person's title.
April 10, 2025
- Added new schema for office / officeholder tenure split.
March 12, 2025
- Added
judge, cabinet member, general purpose officer, and special
purpose officer to office roles and added logic in validator to allow two
combinations of roles: head of government & head of state and cabinet
member & general purpose officer.
March 4, 2025
- Updated
ElectionDateType with
details on how StartDate and EndDate will be interpreted for bounded
elections.
February 26, 2025
- Updated Metadata feed to add note about
waiting 60 days after
FeedInactiveDate to remove a feed from metadata
feed.
January 29, 2025
January 27, 2025
- Updated Contest guidelines to add
PassageThreshold definition to BallotMeasureContest
January 15, 2025
- Updated guidelines for the
FeedInactiveDate property of the metadata
Feed entity.
November 19, 2024
November 11, 2024
November 1, 2024
- Update
EmptyText validator rule to raise an error instead of a warning.
August 26, 2024
- Update the OfficeLevel enum to add
detailed descriptions.
July 17, 2024
July 10, 2024
- Adding recommendations for the 'FeedInactiveDate' and
SourceDirPath
June 24, 2024
- Update
PartyId to allow for multiple PartyIds for
Candidate and
Person entities.
June 21, 2024
May 14, 2024
- Clean the
PartyContest entity to only include the relevant elements
PartyContest.
- Added updated definitions for
ElectionDateStatus enum values,
particularly,
tentative and changing.
May 1, 2024
- Clarified the definition for the
IsIndependent element for
Party.
April 29, 2024
- Update FeedType enum and
FeedLongevity enum to use lower
case values in their respective reference pages.
April 17, 2024
- Added an
IsIndependent element to the reference page for
Party.
February 12, 2024
- Added documentation throughout the site for the new
Metadata feed.
January 9, 2024
January 3, 2024
July 24, 2023
- Added
Committee type for Political Committees and a corresponding
feed type
January 20, 2023
- Added a
Slogan element to the reference page for
Party.
- Added a
CampaignSlogan element to the reference page for
Candidate.
November 17, 2022
December 30, 2021
- Added a
PartialDate section to the
Simple Data Types page, as well
as updating some of the table fields.
December 27, 2021
- Modified content within the
CandidateContest section of the
Contest page to support only one office
per contest, as well as updating some of the XML examples.
October 15, 2021
- Added ExternalIdentifier section to the reference page for
Candidate.
August 20, 2021
February 26, 2021
- Added an example to the
Term reference page on
how to represent the tenure of reelected officeholders in an Officeholder
feed.
February 24, 2021
- Added information about
party-chair-id to the
Party
reference material.
February 18, 2021
- Added a diagram to the
CandidatePreElectionStatus reference material that
illustrates the timing of statuses.
December 14, 2020
- Added Guides pages that describe the available feed types. Updated the
Reference pages to provide best practices to follow for most entities.
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-08-05 UTC.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-05 UTC."],[[["\u003cp\u003eRecent updates include clarifying definitions for elements like \u003ccode\u003eIsIndependent\u003c/code\u003e for parties and updating enums like \u003ccode\u003eOfficeLevel\u003c/code\u003e and \u003ccode\u003ePartyLeadershipType\u003c/code\u003e for better data representation.\u003c/p\u003e\n"],["\u003cp\u003eDocumentation has been enhanced with examples and guides for entities such as \u003ccode\u003eOfficeHolderSubFeed\u003c/code\u003e, \u003ccode\u003ePartyContest\u003c/code\u003e, and the \u003ccode\u003eMetadata\u003c/code\u003e feed.\u003c/p\u003e\n"],["\u003cp\u003eSupport for new data points like \u003ccode\u003eTiktok\u003c/code\u003e accounts, multiple \u003ccode\u003ePartyId\u003c/code\u003es for candidates and persons, and the \u003ccode\u003eCommittee\u003c/code\u003e feed type has been added.\u003c/p\u003e\n"],["\u003cp\u003eThe data schema has been refined with updates to \u003ccode\u003eCandidateContest\u003c/code\u003e supporting only one office per contest and \u003ccode\u003ePartialDate\u003c/code\u003e section added to simple data types.\u003c/p\u003e\n"],["\u003cp\u003eBest practices and internal considerations regarding data translation and OCD ID updates are also provided.\u003c/p\u003e\n"]]],[],null,["# Revision history\n\nChanges to the CDF documentation are listed here.\n\nAugust 5, 2025\n--------------\n\n- Update `Feed` documentation and Validator support for `FeedType` of `voter-information`.\n\nJuly 23, 2025\n-------------\n\n- Add additional values to `VoterInformationWebsiteType`.\n\nJuly 11, 2025\n-------------\n\n- Added `RetentionContest` to the available `Contest` [types](/civics-data/reference/contest#types).\n\nJuly 7, 2025\n------------\n\n- Updated Metadata `Feed` documentation and validator to clarify canceled election events don't need to be considered when determining a Feed inactive date.\n\nJune 25, 2025\n-------------\n\n- Added `whatsapp` as a platform for `AnnotatedUri`.\n\nJune 16, 2025\n-------------\n\n- Updated Voter Information documentation for `VoterInformationWebsite` and `ElectoralCommissionWebsite` to reflect definitions in the CDF schema.\n\nMay 29, 2025\n------------\n\n- Replaced `NoSourceDirPathBeforeInitialDeliveryDate` validator rule with `SourceDirPathMustBeSetAfterInitialDeliveryDate`.\n\nMay 27, 2025\n------------\n\n- Added Validator support and basic checks for Voter information feeds.\n\nMay 22, 2025\n------------\n\n- Published a [guide](/civics-data/guides/term-dates) to aid in determining officeholder term dates.\n\nMay 13, 2025\n------------\n\n- Updated the [feed types guide](/civics-data/guides/feed-types) to include Voter information feeds.\n\nMay 7, 2025\n-----------\n\n- Added elements to support Voter information including\n [`VoterInformation`](/civics-data/reference/voter-information),\n [`VoterInformationWebsite`](/civics-data/reference/voter-information-website),\n [`VoterInformationWebsiteType`](/civics-data/reference/voter-information-website-type),\n [`ElectoralCommission`](/civics-data/reference/electoral-commission), and\n [`InternationalizedUri`](/civics-data/reference/internationalized-uri).\n\n- Refactored information about\n [`LanguageString`](/civics-data/guides/international-considerations#language-string)\n into the\n [International considerations guide](/civics-data/guides/international-considerations).\n\nMay 6, 2025\n-----------\n\n- Update `PersonHasOffice` rule to check new `OfficeHolderTenure` schema.\n\nApril 18, 2025\n--------------\n\n- Added clarification that `FullName` elements of [People](/civics-data/reference/person#elements) shouldn't contain the person's title.\n\nApril 10, 2025\n--------------\n\n- Added new schema for office / officeholder tenure split.\n\nMarch 12, 2025\n--------------\n\n- Added `judge`, `cabinet member`, `general purpose officer`, and `special\n purpose officer` to office roles and added logic in validator to allow two combinations of roles: `head of government` \\& `head of state` and `cabinet\n member` \\& `general purpose officer`.\n\nMarch 4, 2025\n-------------\n\n- Updated [`ElectionDateType`](/civics-data/reference/election-date-type) with details on how `StartDate` and `EndDate` will be interpreted for `bounded` elections.\n\nFebruary 26, 2025\n-----------------\n\n- Updated Metadata [feed](/civics-data/reference/feed) to add note about waiting 60 days after `FeedInactiveDate` to remove a feed from metadata feed.\n\nJanuary 29, 2025\n----------------\n\n- Created new Title syntax [guide](/civics-data/reference/title-syntax) to standardise [election](/civics-data/reference/election) and [contest](/civics-data/reference/contest) titles.\n\nJanuary 27, 2025\n----------------\n\n- Updated [Contest](/civics-data/reference/contest) guidelines to add `PassageThreshold` definition to `BallotMeasureContest`\n\nJanuary 15, 2025\n----------------\n\n- Updated guidelines for the `FeedInactiveDate` property of the metadata [Feed](/civics-data/reference/feed) entity.\n\nNovember 19, 2024\n-----------------\n\n- Added documentation for [GovernmentBody](/civics-data/reference/government-body)\n\nNovember 11, 2024\n-----------------\n\n- Added [documentation](/civics-data/guides/filename-file-formatting) requiring feed filenames to remain static\n\nNovember 1, 2024\n----------------\n\n- Update `EmptyText` validator rule to raise an error instead of a warning.\n\nAugust 26, 2024\n---------------\n\n- Update the [OfficeLevel](/civics-data/reference/office-level) enum to add detailed descriptions.\n\nJuly 17, 2024\n-------------\n\n- Added documentation for new [PartyLeadership](/civics-data/reference/party-leadership) entities and associated [PartyLeadershipType](/civics-data/reference/party-leadership-type) enum.\n\nJuly 10, 2024\n-------------\n\n- Adding recommendations for the 'FeedInactiveDate' and `SourceDirPath`\n\nJune 24, 2024\n-------------\n\n- Update `PartyId` to allow for multiple `PartyId`s for [Candidate](/civics-data/reference/candidate) and [Person](/civics-data/reference/person) entities.\n\nJune 21, 2024\n-------------\n\n- Update the documentation for [OfficeHolderSubFeed](/civics-data/reference/officeholder-sub-feed) entity to share a detailed example.\n\nMay 14, 2024\n------------\n\n- Clean the `PartyContest` entity to only include the relevant elements [PartyContest](/civics-data/reference/*%20contest#party-contest).\n- Added updated definitions for [ElectionDateStatus](/civics-data/reference/date-status) enum values, particularly, `tentative` and `changing`.\n\nMay 1, 2024\n-----------\n\n- Clarified the definition for the `IsIndependent` element for [Party](/civics-data/reference/party).\n\nApril 29, 2024\n--------------\n\n- Update [FeedType](/civics-data/reference/feed-type) enum and [FeedLongevity](/civics-data/reference/feed-longevity) enum to use lower case values in their respective reference pages.\n\nApril 17, 2024\n--------------\n\n- Added an `IsIndependent` element to the reference page for [Party](/civics-data/reference/party).\n\nFebruary 12, 2024\n-----------------\n\n- Added documentation throughout the site for the new [Metadata](/civics-data/reference/data-schema?feed=metadata) feed.\n\nJanuary 9, 2024\n---------------\n\n- Add support for `Tiktok` accounts as an [AnnotatedUri](/civics-data/reference/uri-annotation)\n\nJanuary 3, 2024\n---------------\n\n- Updating [Internal Considerations](/civics-data/guides/translations) with a bit more nuance about how and when to translate or transliterate data.\n\nJuly 24, 2023\n-------------\n\n- Added `Committee` type for Political Committees and a corresponding [feed type](/civics-data/reference/data-schema?feed=committee#feed)\n\nJanuary 20, 2023\n----------------\n\n- Added a `Slogan` element to the reference page for [Party](/civics-data/reference/party).\n- Added a `CampaignSlogan` element to the reference page for [Candidate](/civics-data/reference/candidate).\n\nNovember 17, 2022\n-----------------\n\n- Added guide for [Process to update OCD IDs](/civics-data/guides/process-to-update-ocd-ids)\n\nDecember 30, 2021\n-----------------\n\n- Added a `PartialDate` section to the [Simple Data Types](/civics-data/reference/simple-data-types) page, as well as updating some of the table fields.\n\nDecember 27, 2021\n-----------------\n\n- Modified content within the `CandidateContest` section of the [Contest](/civics-data/reference/contest) page to support only one office per contest, as well as updating some of the XML examples.\n\nOctober 15, 2021\n----------------\n\n- Added ExternalIdentifier section to the reference page for [Candidate](https://developers.google.com/civics-data/reference/candidate).\n\nAugust 20, 2021\n---------------\n\n- Created an [`OfficeSelectionMethod`](/civics-data/reference/office-selection-method) page, added the `SelectionMethod` element to the `Office.` [Elements](/civics-data/reference/office?feed=officeholder#elements) table, and updated codel [examples](/civics-data/reference/office?feed=officeholder#examples).\n\nFebruary 26, 2021\n-----------------\n\n- Added an example to the [Term](/civics-data/reference/term?feed=officeholder#feed) reference page on how to represent the tenure of reelected officeholders in an Officeholder feed.\n\nFebruary 24, 2021\n-----------------\n\n- Added information about `party-chair-id` to the [Party](/civics-data/reference/party#additional-types-external-identifiers) reference material.\n\nFebruary 18, 2021\n-----------------\n\n- Added a diagram to the `CandidatePreElectionStatus` reference material that illustrates the timing of statuses.\n\nDecember 14, 2020\n-----------------\n\n- Added Guides pages that describe the available feed types. Updated the Reference pages to provide best practices to follow for most entities."]]