Table

Table is a direct WebPageElement subtype for HTML tables embedded in a page. No unique properties.

For downloadable spreadsheet files, use SpreadsheetDigitalDocument. For structured datasets, use Dataset. Use Table for in-page rendering metadata (the HTML table element itself).

Full example of schema.org/Table json-ld markup

The markup is verified as valid with Rich Results Test from Google.

schema.org/Table

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Table",
  "name": "XooStructured plan comparison",
  "about": "Side-by-side comparison of Starter, Team, and Enterprise plans.",
  "cssSelector": "table.plans"
}
</script>

Minimal valid version

The smallest markup that still produces a valid Table 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.

schema.org/Table (minimal)

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Table",
  "name": "Plan comparison",
  "cssSelector": "table.plans"
}
</script>

Google rich results this unlocks

Table is a structural type. It does not produce a rich result on its own.

Its value comes from combining it with a primary type whose markup earns a rich result (Article, Product, Event, and so on). Table becomes the trunk that the primary type branches off viamainEntityorbreadcrumb. Include it on every page as the backbone of your markup.

Common Table 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
Table for downloadable spreadsheets
Wrong
```
Table for an XLSX file
```
Right
```
SpreadsheetDigitalDocument for files; Table for in-page tables
```
Different surfaces: file vs rendered element.
02
Table for datasets
Wrong
```
Table for a public dataset
```
Right
```
Dataset + DataDownload for datasets; Table only for HTML rendering
```
Datasets carry publishing / licensing / distribution metadata Table does not.

Schema properties in this example

Table WebPageElement CreativeWork name about cssSelector

About the example data

The pricing-tier comparison table on the XooStructured pricing page.

Comments

Loading comments...