Dataset schema incomplete: add name and description

What it means

This page has Dataset (or DataCatalog / DataDownload) JSON-LD but is missing a required field: name or description. Reported as a notice. IMPORTANT: Dataset structured data affects only Google Dataset Search (datasetsearch.research.google.com) — it produces NO rich result, snippet, or carousel in main Google Search.

Why it matters

Dataset markup's sole purpose is eligibility for Google Dataset Search, a separate index for research and open data used by scientists, journalists, and analysts. If your audience is general web traffic, this notice has no effect on your main SERP performance. Where Dataset Search matters, name must be descriptive and unique across your collection (non-unique names get collapsed or de-ranked), and description should be 50–5,000 characters — shorter is treated as insufficient, longer is silently truncated. The description is the primary field Dataset Search matches queries against, so vague text directly limits discoverability. When a DataDownload is included, distribution.contentUrl is required.

How to fix it

1. Add a descriptive name that is unique within your dataset collection.
2. Write a description between 50 and 5,000 characters covering scope, methodology, and time range.
3. If a download is offered, add a distribution block with contentUrl (and encodingFormat).
4. Add recommended fields: identifier (a DOI), license (a versioned URL, not just "CC BY 4.0"), temporalCoverage, spatialCoverage, creator.
5. Use citation only for related academic articles, never to cite the dataset itself.
6. Validate structure with the Rich Results Test, then confirm indexing in Dataset Search itself.

Example

{
  "@context": "https://schema.org",
  "@type": "Dataset",
  "name": "City Air Quality 2026"
}

{
  "@context": "https://schema.org",
  "@type": "Dataset",
  "name": "City Air Quality 2026",
  "description": "Hourly PM2.5 and NO2 readings from 42 municipal sensors, Jan-Dec 2026.",
  "license": "https://creativecommons.org/licenses/by/4.0/",
  "distribution": [{"@type":"DataDownload","encodingFormat":"text/csv","contentUrl":"https://example.com/air-2026.csv"}]
}

name and description are required. Dataset markup surfaces only in Google Dataset Search, not the main SERP — add distribution and license so the entry is actually usable.

When it's not a problem

If your site does not publish datasets meant for research or data reuse, this notice is irrelevant to your SEO goals — Dataset schema has no effect on main Google Search. Markup added experimentally can be safely ignored or removed to cut noise. A description shorter than 50 characters is a real content gap, not a false positive — expand it. It does not overlap with schema.invalid.

How Crawlinx detects it

We check every Dataset JSON-LD block for name and description. Note this rule is notice-severity: Dataset rich results appear only in Google Dataset Search, so it never affects main Search ranking.

How common is it?

Not yet observed in our audit sample. We publish this explainer because the check runs on every crawl; once an audited site trips it, this page will break the issue down by platform, gatekeeper, vertical and country.

FAQ

Where do Dataset rich results appear?

In Google Dataset Search (datasetsearch.research.google.com), not in the main web results. The markup makes a research or open-data dataset discoverable there.

What's the minimum Dataset markup?

name and description. To be genuinely useful add distribution (a DataDownload with encodingFormat and contentUrl), license, and creator or publisher.

Does Dataset schema help normal SEO?

Not directly — it won't change your position in ordinary Search. Its value is inclusion in Dataset Search, which matters for research, government and open-data publishers.