DataFeed
DataFeed is a Dataset subtype for feeds that publish a stream of data-carrying items over time: live-action government data, sensor telemetry feeds, marketplace inventory feeds, news-alert feeds. It adds 1 direct property:
dataFeedElement(DataFeedItem, Thing, or Text): the elements of the feed. A feed typically has many.
For batch-downloadable datasets use Dataset directly; for items-updated-over-time use DataFeed.
Full example of schema.org/DataFeed json-ld markup
The markup is verified as valid with Rich Results Test from Google.
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "DataFeed",
"@id": "https://dunmore.gov.example/open-data/air-quality/feed",
"name": "Dunmore air-quality hourly feed",
"description": "PM2.5, PM10, ozone, and NO2 readings from the municipal monitoring station at Dunmore Memorial Park, emitted once per hour.",
"url": "https://dunmore.gov.example/open-data/air-quality/feed",
"license": "https://creativecommons.org/publicdomain/zero/1.0/",
"publisher": { "@type": "GovernmentOrganization", "name": "Borough of Dunmore" },
"dataFeedElement": [
{ "@type": "DataFeedItem", "dateCreated": "2026-04-15T09:00:00-04:00", "item": { "@type": "Observation", "measuredProperty": "PM2.5", "observationDate": "2026-04-15T09:00:00-04:00", "value": 8.2, "unitText": "µg/m³" } },
{ "@type": "DataFeedItem", "dateCreated": "2026-04-15T10:00:00-04:00", "item": { "@type": "Observation", "measuredProperty": "PM2.5", "observationDate": "2026-04-15T10:00:00-04:00", "value": 9.1, "unitText": "µg/m³" } }
]
}
</script>Minimal valid version
The smallest markup that still produces a valid DataFeed entity. Use it as the floor. Reach for the advanced example above when you want search engines and AI agents to understand more about your content.
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "DataFeed",
"name": "Dunmore air-quality hourly feed",
"dataFeedElement": [{ "@type": "DataFeedItem", "dateCreated": "2026-04-15T09:00:00-04:00" }]
}
</script>Google rich results this unlocks
Markup matching this example makes your page eligible for the following Google Search rich results. The primary target drives the required / recommended property classification in the advanced code block above.
- Google docsDataset rich result (via Dataset)primary
Common DataFeed mistakes
Mistakes that pass validation but silently fail to earn rich results or mislead consumers walking the graph. Avoid these and your markup will be ahead of most sites in the wild.
- 01
Dataset for continuously-updated feeds
WrongDataset for a live sensor streamRightDataFeed when items are updated over time; Dataset for batch-downloadable snapshotsFeed consumers poll dataFeedElement; Dataset consumers fetch distribution URLs. Using the wrong type routes consumers incorrectly.
Schema properties in this example
About the example data
The Dunmore municipal air-quality feed, emitting hourly Observation items.
Comments
Loading comments...