Compliance first: We never take HIPAA/PHI data or personal customer data. Everything is de-identified before it leaves your control.
Home / Guidelines / Open data policy guideline 13
Open data policy guideline 13

Metadata: Open Data Policy Guideline 13

Metadata: Open Data Policy Guideline 13

Guideline 13 asks open data policies to require a common, fully described metadata scheme so each data set explains what it contains, how it was created, how current it is and how it can be used.

What metadata does

Metadata is data about data: the title, description, owner, update frequency, field definitions, geographic coverage and date range of a data set. Without it, users cannot judge whether data fits their purpose or how to interpret it.

The guideline recommends a common scheme across all agencies, ideally aligned with international vocabularies such as DCAT. Consistent fields help the public search catalogs, help governments share data internally, and let software discover data sets automatically.

How policies typically phrase it

  • A requirement that each published data set include minimum metadata.
  • Specific required fields, such as publication date, last update and whether the data is primary or aggregated.
  • Field-level descriptions, sometimes called a data dictionary.
  • Delegation of the metadata schema to technical standards.

Places whose policies adopted it

Cook County's 2011 ordinance is an early example, requiring its catalog to show whether information is public, when it was published and last updated, and whether it is primary or modified. Minneapolis's 2014 ordinance asks departments to describe data fields and meet minimum metadata requirements explaining how and when data was collected. Boston's 2014 executive order calls for minimum documentation standards.

Other tagged examples include Chicago, Montgomery County, Nashville and Washington, DC (2014).

Common pitfalls

  • Title-only metadata, which tells users almost nothing.
  • No field definitions, so column names remain cryptic.
  • Stale update dates, which erode trust in the whole catalog.

A minimum metadata set

Most technical standards for municipal portals settle on a short list of required fields, with more detail encouraged. A reasonable minimum is:

  • Title and plain-language description.
  • Publishing department and a contact point.
  • Date first published and date last updated.
  • Update frequency and temporal coverage.
  • Geographic coverage and spatial unit.
  • Field-level definitions (a data dictionary).
  • License or public domain statement.
  • Notes on known limitations or methodology.

Aligning these fields with a common vocabulary such as DCAT or the Project Open Data schema lets catalogs be harvested by regional, state and national aggregators. Equally important is keeping metadata current; an update date that is months out of step with the data undermines confidence in the whole portal, so many policies assign metadata upkeep to the same steward who maintains the data.

Why this matters for your business data

Documentation is one of the cheapest ways to raise the value of operational data. A buyer evaluating a data set needs to know what each field means, how far back it goes and how often it refreshes. Well-documented data sells faster and for more.

Use the valuation calculator to see how completeness affects value, and read how to value my data. We never take HIPAA/PHI data or personal customer data. Everything is de-identified before it leaves your control.

Our compliance promise: We never take HIPAA/PHI data or personal customer data. Everything is de-identified before it leaves your control.

Frequently asked questions

What metadata should every open data set have?

Typically a title, description, owning agency, contact, publication and update dates, update frequency, coverage period, geographic scope and definitions for each field.

What is DCAT?

DCAT (Data Catalog Vocabulary) is a W3C standard for describing data sets in catalogs. Aligning with it helps catalogs interoperate and lets search tools discover data automatically.

Is a data dictionary part of metadata?

Yes. A data dictionary describes each field in a data set and is one of the most useful forms of metadata for people analyzing the data.

Policies in the index that reflect guideline 13

PlaceAdoptedInstrumentGuidelines
Washington, DCJun 12, 2006Executive memorandum1131822
Cook County, ILMay 4, 2011Ordinance12378131825
Madison, WIAug 15, 2012Ordinance457810111318
Chicago, ILDec 10, 2012Executive order34678101113
Montgomery County, MDDec 17, 2012County legislation (Bill 23-12, Open Data Act)457811131822
Oakland, CAOct 15, 2013Council resolution (No. 84659)2345781011
Boston, MAApr 7, 2014Executive order3891318202425
Nashville, TNMay 12, 2014Executive order (No. 043)2345781011
Kansas City, MOJun 19, 2014Ordinance (No. 140443)81018242713
Washington, DCJul 21, 2014Executive directive (Mayor's Order 2014-170)12356789
Minneapolis, MNAug 1, 2014Council-adopted policy34568131819
Boston, MAJul 30, 2015Administrative policy478132425
Suffolk County, NYJul 31, 2015Administrative policy78131820222426
Cambridge, MASep 21, 2015Ordinance12345678
Seattle, WAFeb 1, 2016Administrative policy (CTO policy)14678101112
Baltimore, MDMar 7, 2016Ordinance1781113182426
San Jose, CAApr 5, 2016Council policy1681113182230
Saint Paul, MNApr 27, 2016Council resolution12578101113
Milwaukee, WIJul 14, 2016Council resolution12356789
Naperville, ILNov 15, 2016Council resolution45789101112
Fort Collins, COFeb 7, 2017Council resolution12345678
Knoxville, TNMay 2, 2017Executive order14578111319
Syracuse, NYJul 26, 2017Executive order1456781113

Sources

  1. Sunlight Foundation, Open Data Policy Guidelines (historical reference)
  2. Project Open Data metadata schema
  3. City of New York open data technical standards, city standards

Updated December 31, 2024.