How should dataset download options and tabular data be marked up?

ProcrustesPR

When a dataset has download options, you can use distribution to describe the download location and file format, and distribution.contentUrl to specify the download link. Different formats can be listed separately. For web pages with directly embedded tabular data, the Google documentation cited here also introduces CSVW markup. However, it explicitly labels that version as Beta, so this alone does not establish that it is currently supported. The two approaches address different questions: how to obtain the data and how to describe tables on the page.

ProcrustesPRProcrustesPRWill structured data improve rankings or AI citations?

Distinguish download URLs from dataset description pages

A dataset URL often points to a page describing the dataset rather than to the data file itself. Use distribution to specify the data’s actual location and format, so readers have more than a description page and can find the download.

  • distribution: Uses DataDownload to describe the download location and file format; the documentation cited here lists it as a recommended property.
  • distribution.contentUrl: Specifies the download link; the documentation lists it as a required property in its description of download options.
  • distribution.encodingFormat: Describes the file format of the published content; the documentation lists it as a recommended property.

For example, if the same data is available in both CSV and Excel formats, each with its own download URL, distribution can contain multiple values describing the two versions and their formats, rather than just listing their shared description page.

Marking up embedded tables is not the same as providing download options

A tabular dataset is primarily presented as a grid of rows and columns. For web pages that directly embed this type of data, the documentation describes using more explicit CSVW markup in addition to the basic approach. CSVW stands for “CSV on the Web.”

The documentation describes a CSVW variant included in an HTML page alongside the table content that users can see. It does not claim that all forms of CSVW markup are supported. This version is explicitly labeled Beta, and the approach may change, so the description cannot be treated as current official guidance. Separately, download file settings cannot replace a description of an embedded table.

Pair download information with a basic dataset description

A download location only explains how to obtain the file; the dataset itself also needs a clear description. The Google documentation states that providing structured metadata such as a name, description, creator, and distribution formats helps Dataset Search find datasets. Dataset Search uses schema.org and other metadata standards that can be used on dataset description pages.

When organizing this information, check what the dataset is, who created it, and which formats are available to download. Markup aims to make datasets easier to find; it does not guarantee a particular appearance in search results. The documentation cited here also cautions that the actual display may differ.

ProcrustesPRProcrustesPRHow to choose a CMS for SEO: start with control over features and your team’s needs

Dataset downloads and tabular data: perspectives from across the web

When is a table an appropriate way to present content on a web page?

Tables are appropriate for data with natural relationships between rows and columns, such as tabular datasets, or inputs, outputs, and form content that naturally fit a tabular arrangement. Tables are not recommended solely for page layout. First determine whether the content itself has a tabular structure, rather than considering only layout needs.

Do only CSV files count as datasets?

No. The Google documentation cited here also lists tables containing data, organized collections of tables, data files in other formats, and collections of files that together form a meaningful dataset. The examples also include files related to machine learning, so datasets are not limited to a single file format.

ProcrustesPRHow do you choose and use WordPress SEO plugins?

References

  1. 資料集結構化資料 | Google 搜尋中心  |  Documentation  |  Google for Developersdevelopers.google.com — Discusses: Do only CSV files count as datasets?
  2. Are HTML tables bad for SEO?webmasters.stackexchange.com — Discusses: When is a table an appropriate way to present content on a web page?

Related articles

Will structured data improve rankings or AI citations?How to choose a CMS for SEO: start with control over features and your team’s needsHow do you choose and use WordPress SEO plugins?How can content, links, and structured data help build website credibility?What elements appear on Google search results pages, and why does their appearance vary?How Can Websites Improve E-E-A-T or E-A-T? Start with Content, Authors, and Trust InformationHow Can Understanding Google Search Result Elements Help SEO?How do you plan keywords and create and optimize content for voice search?
ProcrustesPR
ProcrustesPR