Page Summary
-
Recent updates include guidelines for
ElectoralCommissionNames and example XML. -
Documentation and Validator support have been updated for the
voter-informationFeedType. -
Additional values have been added to
VoterInformationWebsiteType. -
RetentionContesthas been added to the availableContesttypes.
Changes to the CDF documentation are listed here.
Nov 19, 2026
- Updated
MissingFieldsWarningvalidator rule to warn when a PartyContest is missingNumberElectedorTotalSeats. - Updated the virtual contest sample feed to set
NumberElectedandTotalSeatson its PartyContest. - Updated the schema to require
FullNameinPerson,PersonIdinCandidate,PartyScopeGpUnitIdsinPartyandCoalition, andPartyIdsinCoalition. Removed theMissingFieldsErrorandCoalitionPartiesvalidator rules, which used to report these as errors. TheSchemarule now reports them as fatal. - Updated the schema to enforce
GenderinPersonas an enumeration of the documented values (lowercase, title case, and uppercase). Removed thePersonsHaveValidGendervalidator rule, which used to check this. - Removed the
DuplicateIDvalidator rule (theSchemarule already reports repeatedobjectIdvalues) and the unusedMissingFieldsInforule. - Removed the
ElectionContainsStartAndEndDatesvalidator rule. TheSchemarule already reports anElectionwithout aStartDateorEndDate. - Updated the schema to require exactly one of
PartyIdorPersonIdinAffiliation. Removed theAffiliationHasEitherPartyOrPersonvalidator rule, which used to check this.
Nov 18, 2026
- Added the
RequiredContestResultsFieldsSetvalidator rule for election results feeds. It reports an error when aContestis missingCurrentResultsReportingStageorResultsReportingStageCollection. - Updated
RequiredContestResultsFieldsSetvalidator rule to also report an error when a Contest is missingResultsExpected. - Added the
DataSourcesRequiredvalidator rule for election results feeds. It reports an error when theElectionReportis missingDataSourceCollection. - Added the
ValidatePercentReportingvalidator rule for election results feeds. It reports an error when aContestsets neitherEstimatedExpectedVotePercentagenor bothSubUnitsReportedandTotalSubUnits. - Fixed validator rules that only checked a base element type, such as
Contest,BallotSelectionorParty, so they also check its subtypes, such asCandidateContest,RetentionContest,PartySelectionorCoalition. Before this, these rules never ran on feeds that setxsi:typeon those elements. - Updated
PercentSumvalidator rule to also count thetotal-percentvote counts of aContest'sAggregateBallotSelection,BlankBallotSelection,NoneOfTheAboveBallotSelection, andNullBallotSelection, instead of only the ones in itsBallotSelectionelements. - Fixed more validator rules so they also check element subtypes:
GpUnitsHaveInternationalizedNamenow checks everyGpUnit,GpUnitOcdIdchecks everyGpUnitsubtype exceptReportingDevice,BallotTitlechecksRetentionContests,MissingStableIdsandAllCapscheckRetentionContests,AllCapschecksBallotMeasureContests, andMissingFieldsErrorchecksCoalitions.VoteCountTypesCoherencynow reads the contest type fromxsi:type, so it actually runs. - Fixed
ValidPartyLeadershipDatesvalidator rule to checkLeadershipelements. Before this, it looked for aPartyLeadershipelement, which feeds never contain, so it never ran. - Updated the sample feeds to give every
GpUnitanInternationalizedNameand everyRetentionContestaBallotText. - Added
InternationalizedAbbreviationtoContestand deprecatedAbbreviationin favor of it.
Nov 17, 2026
- Added
nonqualified-write-inandqualified-write-intoCandidatePreElectionStatus.
Nov 13, 2026
- Updated the validator CLI to fetch OCD IDs for all countries when
-cis omitted or empty, instead of defaulting tous. - Fixed
DateOfBirthIsInPastvalidator rule to check each Person on its own and report every Person with a date of birth in the future, instead of only the first one. - Updated
UniqueDataSourceLanguagesvalidator rule to check each DataSource on its own and to point errors about repeated Uri languages at the repeated Uri, instead of at the whole DataSourceCollection. - Updated validator rule warnings, errors, and fatal messages to point at
the feed elements they are about, so they include line numbers. Messages
that don't belong to one element point at the closest one, such as the
root
ElectionReportfor file encoding problems.
Nov 12, 2026
- Fixed
RulesRegistry.get_all_exceptions()in the validator library to return the recorded exceptions instead ofNone. - Updated the validator command line to exit with code 4 when it finds fatal messages, instead of 0.
- Updated the
Schemavalidator rule to report schema validation failures as fatal instead of errors. - Updated
MissingPartyAbbreviationTranslationvalidator rule to apply to all feed types except metadata feeds, instead of only election and election dates feeds. - Updated
MissingPartyNameTranslationvalidator rule to apply to all feed types except metadata feeds, instead of only election and election dates feeds. - Updated
DateOfBirthIsInPastvalidator rule to apply to all feed types except metadata feeds, instead of only officeholder feeds. - Updated
GpUnitsHaveSingleRootvalidator rule to apply to all feed types except metadata feeds, instead of only election and election dates feeds. - Fixed
ElectionDatesSpanContestDatesvalidator rule to report every Contest with dates outside of its Election, instead of only the last one. - Fixed the error message of the
ComposingContestIdsAreValidRelatedContestsvalidator rule when a composing contest can't be found. - Fixed
SubsequentContestIdIsValidRelatedContestvalidator rule crashing when neither a contest nor its election has an end date, and reusing a previous contest's end date for an election without one.
Nov 11, 2026
- Updated
CoalitionPartiesvalidator rule to apply to all feed types except metadata feeds, instead of only election and election dates feeds. - Updated
DuplicatedPartyAbbreviationvalidator rule to apply to all feed types except metadata feeds, instead of only election and election dates feeds. - Updated
DuplicatedPartyNamevalidator rule to apply to all feed types except metadata feeds, instead of only election and election dates feeds.
Nov 10, 2026
- Updated
MultipleInternationalizedTextWithSameLanguageCodevalidator rule to apply to all feed types except metadata feeds, instead of only election and election dates feeds.
Nov 2, 2026
- Added
disqualifiedandsub-judicetoCandidatePreElectionStatus. - Added
defeated,did-not-participate,disqualified,projected-advanced-to-runoff, andsub-judicetoCandidatePostElectionStatus. - Deprecated
withdrawninCandidatePostElectionStatus. - Updated
Candidateto clarify thatPreElectionStatusandPostElectionStatusare the candidate's overall final status across related contests, and that per-contest statuses belong onCandidateSelection. - Updated
Contestto clarify the granularity ofSubUnitsReportedandTotalSubUnits. - Added
InheritFromComposedContesttoResultsReportingStageCollectioninContest. - Added
ValidateResultReportingStagesvalidator rule to ensure thatResultsReportingStageCollectioncontains noResultsReportingStageelements and that itsContestis listed in theComposingContestIdsof anotherContestwhenInheritFromComposedContestistrue, that it contains at least oneResultsReportingStageotherwise, and to warn if it doesn't contain at least twoResultsReportingStageelements (one of typeno-resultsand at least one of typepreliminaryorofficial). - Added
InheritFromComposedContesttoResultsReportingStageCollectioninContest. - Added
ValidateResultReportingStagesvalidator rule to ensure thatResultsReportingStageCollectioncontains noResultsReportingStageelements whenInheritFromComposedContestistrueand at least one otherwise, and to warn if it doesn't contain at least twoResultsReportingStageelements (one of typeno-resultsand at least one of typepreliminaryorofficial). - Updated
CandidatesReferencedInRelatedContestsvalidator rule and Candidate reference documentation to once again treat subsequent contests as related contests, so aPersonmust be referenced by the sameCandidateacross subsequent contests.
Oct 28, 2026
- Updated
Contestto remove composing contest inheritance fromEarliestPollsClose,LatestPollsClose,ResultsEmbargoEnd, andResultsExpected.
Oct 23, 2026
- Updated
GpUnitOcdIdvalidator rule to checkReportingUnitelements.
Oct 22, 2026
- Added
OutcomeDeterminedtoContest.
Oct 21, 2026
- Updated
Contestto clarify thatResultsReportingStageCollectionshould contain the full set of expected stages with their attribution rather than only the current stage, which goes inCurrentResultsReportingStage.
Oct 16, 2026
- Added
ContestDateTypetoContest. - Added
NoResultsProvidedtoResultsReportingStage.
Oct 15, 2026
- Added
AliastoPerson.
Oct 13, 2026
- Added
PreElectionStatusandPostElectionStatustoCandidateSelection. - Added
diplomattoOfficeRole. - Added
DiplomatSendingStateIdandDiplomatReceivingStateIdtoOffice. - Updated
ValidIDREFvalidator rule to recognizeDiplomatSendingStateIdandDiplomatReceivingStateIdas referencingGpUnitelements - Added
DiplomaticOfficesHaveCorrespondingGpUnitsSetvalidator rule to ensure offices with rolediplomathave at least one of those fields set.
Oct 12, 2026
- Added
EstimatedExpectedVotePercentagetoContest.
Oct 8, 2026
- Removed
ContestStagein favor ofResultsReportingStageandResultsReportingStageType. - Updated
EmptyStringvalidator rule to not raise an error on elements with child elements when no whitespace precedes the first child element.
Oct 6, 2026
- Added
ResultsLastUpdatedtoContest.
Sep 24, 2026
- Added
CandidateImageInContactInformationvalidator rule to warn whencandidate-imageis set inContactInformation.Uriand recommend usingPerson.ImageUriinstead.
Sep 14, 2026
- Updated
CandidatesReferencedInRelatedContestsvalidator rule and Candidate reference documentation to no longer treat subsequent contests as related contests.
Sep 2, 2026
- Added
SqsQueueNameIsFullyQualifiedArnvalidator rule to ensure that ifSqsQueueNameis set in a metadata feed, it is a valid fully qualified SQS ARN.
Aug 28, 2026
- Added
TotalSeatstoContest. - Updated
VoteCountValidSeatsDeltaTypesrule to error on legacyseats-deltainSpecialBallotSelectionelements and also to supportseats-delta-institutionalwithout needing to setseats-delta-mandate.
Aug 27, 2026
- Deprecated legacy JSON feed formats and removed all JSON schema examples across developer guides and reference documentation in favor of CDF XML.
Aug 26, 2026
- Updated examples of stable IDs and object IDs across reference documentation to use Hungarian notation with hyphens.
- Updated the Stable identifiers guide to list prefix recommendations across entity types.
Aug 25, 2026
- Removed
HungarianStyleNotationrule. - Updated the Stable identifiers guide to clarify that Hungarian notation is a best practice but not required, and added prefix examples.
Aug 24, 2026
- Updated the International considerations guide to clarify requirements for English translations of candidate and party names from official sources, reputable press, or partner publications.
Aug 22, 2026
- Updated FeedLongevity and Feed types with guidance on when entities can be removed from evergreen feeds.
Aug 5, 2026
- Updated schema for
CountedInTotalto allow forminOccurs=0in accordance with the documentation.
Jul 29, 2026
- Updated
FeedInactiveDateIsLatestDateto skip checking test feeds. - Added new
DuplicateBallotTitleSeatPairrule to check for duplicate (BallotTitle, Seat) pairs in Contests. - Added new
FeedInactiveDateNotOlderThanOneYearrule.
Jul 17, 2026
- Check that all Uri elements have a valid language code (when specified).
Jul 9, 2026
- Removed deprecated
GovernmentBodyExternalIdrule.
Jun 16, 2026
- Updated legacy government body schema to an error.
Jun 16, 2026
- Added the
Named Entity Changesguide.
Jun 2, 2026
- Added
tse-candidate-numberas an external identifier toCandidate.
May 19, 2026
- Added
ResultsReportingStagesMustHaveUniqueTypevalidator rule to ensure that eachResultsReportingStagein aResultsReportingStageCollectionhas a uniqueStageType.
May 18, 2026
- Added
SqsQueueNameRequiresS3SourceDirPathvalidator rule to ensure that ifSqsQueueNameis set in a metadata feed,SourceDirPathmust also be set and must be an s3 path.
May 7, 2026
- Added
AttributionDepthLimitrule to ensure<Attribution>trees under<ResultsReportingStage>have at most 3 levels of recursion/depth. - Added
AttributionCyclesValidationrule to ensure<Attribution>elements don't contain directed cycles (loops) between nodes.
May 6, 2026
- Added
ValidateIncludeInAggregationBallotSelectionsrule to check that the sum of vote counts for selections marked asIncludedInAggregationdoes not exceed theAggregateBallotSelectionvote count. - Added rule to enforce
CountedInTotalconstraints onSpecialBallotSelections. - Added
ValidateResultsEmbargoEndrule to check thatResultsEmbargoEndis not after the start of theofficialResultsReportingStage. - Added
ValidateResultsExpectedrule to check thatResultsExpectedis not before the firstResultsReportingStage(excluding theno-resultsstage). - Added
NotEmptyUniqueDataSourceUris,UniqueDataSourceLanguages, andUniqueDataSourceDisplayNamesrules to verifyDataSourceCollectionelements. Also, addedDisplayNameto theMultipleInternationalizedTextWithSameLanguageCode.
May 5, 2026
- Added
ValidatePollsCloseDatetimesrule to check thatLatestPollsCloseis not beforeEarliestPollsClose. - Deleted
PartiesHaveValidColorsrule. These values are also validated by the schema forHtmlColorString. - Updated
ValidateDuplicateColorsrule to supportDarkThemeColorandLightThemeColor.
April 30, 2026
- Added
WinnerCountLimitvalidator rule to check that the number of winners or projected winners in a contest does not exceed the number of elected seats. - Removed support for
candidate-imageannotation inContactInformation. - Add rules to restrict
ImageUriwith annotationcandidate-imageto at most one perPersonand also to ensure candidate image URIs are unique across persons.
April 29, 2026
- Added
EmptyStringandEmptyTextrules toMETADATA_RULES.
April 16, 2026
- Added more examples to
metadata_sample_feed.xml. - Fixed multiple sample feed files to ensure they pass validation.
April 14, 2026
- Updated
yearlyfeed longevity to only be allowed forpre-electionfeeds. Feeds of typeelection-resultsmust always belimited.
March 25, 2026
- Updating Metadata sample feed
SourceDirPathvalue to match regular expression expectation.
March 19, 2026
- Added
IsTestandSqsQueueNametoFeed.
March 18, 2026
- Added
SpecialBallotSelectionsubtype ofBallotSelection. - Added
AggregateBallotSelection,BlankBallotSelection,NoneOfTheAboveBallotSelection, andNullBallotSelectiontoContest. - Added
IncludedInAggregationtoCandidateSelectionandPartySelection. - Added
AttributionandDataSourceelement definitions andDataSourceCollectiontoElectionReport. - Added
ResultsReportingStageandResultsReportingStageTypedefinitions andResultsReportingStageCollectionandCurrentResultsReportingStagetoContest. - Added
PartyColorsdefinition andColorstoParty.
March 17, 2026
- Added
IsNotabletoCandidate,Contest, andParty. - Added
PartyLabeltoCandidate. - Added
ImageUritoPerson. - Added
ResultsExpected,ResultsEmbargoEnd,EarliestPollsClose, andLatestPollsClosetoContest.
March 11, 2026
- Removed special handling of
IssuerAbbreviationfromEmptyStringrule.
February 26, 2026
- Restricted
VoteCountsCollectionto one perBallotSelection. (This still allows for multipleVoteCountswithin that collection.)
February 24, 2026
- Fixed references to
OfficeholderSubFeedthat were were incorrectly written asOfficeHolderSubFeed. - Restricted
SourceDirPathin the metadata feed to supported filepath types.
February 23, 2026
- Updated
VoteCountsenumerations to support bothseats-delta-mandateandseats-delta-institutional.
February 18, 2026
- Made
ElectionEventCollectionandOfficeholderSubFeedmutually exclusive in theFeedelement in metadata feeds.
February 12, 2026
- Added guidance to Simple data
types for
PartialDatebeing interpreted as the latest possible date in the range.
February 11, 2026
- Added
OfficeHolderTenuretoMissingStableIdsCDF Validator rule to ensure all officeholder tenures have stable IDs.
January 28, 2026
- Added
FeedElementsShouldHaveSubElementsBasedOnTypeCDF Validator rule to ensureFeedentries in the Metadata Feed have appropriate sub-elements.
January 15, 2026
Delete
ElectoralDistrictOcdIdrule now that it is fully replaced by the broaderGpUnitOcdIdrule.Added
mayoras an Executive Office Role in the CDF Validator.
January 13, 2026
- Added
EmptyStringvalidator rule to check that string fields are not empty or only contain whitespace (temporarily a warning forIssuerAbbreviation).
December 10, 2025
- Updated the CDF XSD to make
IssuerAbbreviationoptional.
November 18, 2025
- Updated
GpUnitOcdIdrule to check allGpUnits expected to have OCD IDs have valid OCD IDs, and replacedElectoralDistrictOcdIdrule with a placeholder until safe to remove.
November 12, 2025
- Added guidance to Simple data types highlighting the need to use the Gregorian calendar for dates.
October 22, 2025
- Updated documentation for new
Officeformat including the newOfficeHolderTenureelement.
September 29, 2025
- Updated guidelines for
ElectoralCommissionNames including example XML.
August 5, 2025
- Update
Feeddocumentation and Validator support forFeedTypeofvoter-information.
July 23, 2025
- Add additional values to
VoterInformationWebsiteType.
July 11, 2025
- Added
RetentionContestto the availableContesttypes.
July 7, 2025
- Updated Metadata
Feeddocumentation and validator to clarify canceled election events don't need to be considered when determining a Feed inactive date.
June 25, 2025
- Added
whatsappas a platform forAnnotatedUri.
June 16, 2025
- Updated Voter Information documentation for
VoterInformationWebsiteandElectoralCommissionWebsiteto reflect definitions in the CDF schema.
May 29, 2025
- Replaced
NoSourceDirPathBeforeInitialDeliveryDatevalidator rule withSourceDirPathMustBeSetAfterInitialDeliveryDate.
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
- Updated the feed types guide to include Voter information feeds.
May 7, 2025
Added elements to support Voter information including
VoterInformation,VoterInformationWebsite,VoterInformationWebsiteType,ElectoralCommission, andInternationalizedUri.Refactored information about
LanguageStringinto the International considerations guide.
May 6, 2025
- Update
PersonHasOfficerule to check newOfficeHolderTenureschema.
April 18, 2025
- Added clarification that
FullNameelements 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, andspecial purpose officerto office roles and added logic in validator to allow two combinations of roles:head of government&head of stateandcabinet member&general purpose officer.
March 4, 2025
- Updated
ElectionDateTypewith details on howStartDateandEndDatewill be interpreted forboundedelections.
February 26, 2025
- Updated Metadata feed to add note about
waiting 60 days after
FeedInactiveDateto remove a feed from metadata feed.
January 29, 2025
January 27, 2025
- Updated Contest guidelines to add
PassageThresholddefinition toBallotMeasureContest
January 15, 2025
- Updated guidelines for the
FeedInactiveDateproperty of the metadata Feed entity.
November 19, 2024
- Added documentation for GovernmentBody
November 11, 2024
- Added documentation requiring feed filenames to remain static
November 1, 2024
- Update
EmptyTextvalidator rule to raise an error instead of a warning.
August 26, 2024
- Update the OfficeLevel enum to add detailed descriptions.
July 17, 2024
- Added documentation for new PartyLeadership entities and associated PartyLeadershipType enum.
July 10, 2024
- Adding recommendations for the 'FeedInactiveDate' and
SourceDirPath
June 24, 2024
June 21, 2024
- Update the documentation for OfficeHolderSubFeed entity to share a detailed example.
May 14, 2024
- Clean the
PartyContestentity to only include the relevant elements PartyContest. - Added updated definitions for
ElectionDateStatus enum values,
particularly,
tentativeandchanging.
May 1, 2024
- Clarified the definition for the
IsIndependentelement 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
IsIndependentelement to the reference page for Party.
February 12, 2024
- Added documentation throughout the site for the new Metadata feed.
January 9, 2024
- Add support for
Tiktokaccounts as an AnnotatedUri
January 3, 2024
- Updating Internal Considerations with a bit more nuance about how and when to translate or transliterate data.
July 24, 2023
- Added
Committeetype for Political Committees and a corresponding feed type
January 20, 2023
- Added a
Sloganelement to the reference page for Party. - Added a
CampaignSloganelement to the reference page for Candidate.
November 17, 2022
- Added guide for Process to update OCD IDs
December 30, 2021
- Added a
PartialDatesection to the Simple Data Types page, as well as updating some of the table fields.
December 27, 2021
- Modified content within the
CandidateContestsection 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
- Created an
OfficeSelectionMethodpage, added theSelectionMethodelement to theOffice.Elements table, and updated codel examples.
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-idto the Party reference material.
February 18, 2021
- Added a diagram to the
CandidatePreElectionStatusreference 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.