Skip to main content
Layout analysis labels every region of a page with a content role. The role is what lets you treat content by its meaning: build an outline from headings, keep tables for data, route charts and formulas to their own handling, and drop page furniture from a body index. This page catalogs the roles. In the structured result, each element names its role with a label from a fixed set. The roles below group those labels by the kind of content they mark.

​
Text roles

A Title or SectionHeader carries a heading_level derived from the document’s typography, so the section hierarchy is preserved. See the parsed document for how levels are assigned.

​
Figure roles

These roles cover regions that are visual rather than textual. Charts, formulas, seals, and pictures are recognized by vision-language models, described in charts, formulas, and vision models.

​
Tables

​
Page furniture

Page headers and footers are the repeating content at the margins of a page rather than part of the document body. Filtering them out by label keeps them out of a body-text index.

​
Legacy labels

A few labels remain for backward compatibility but are not produced by the current layout model: ListItem, Form, KeyValueRegion, CheckboxSelected, and CheckboxUnselected. A list item in a document parsed by the current model comes through as Text.

​
Handling unknown roles

Treat the set of labels as open. The vocabulary can grow, so branch on the labels your application handles and fall through gracefully on the rest rather than assuming a fixed, exhaustive list.

The parsed document

How typed elements form the document model.

Output schema

The fields each element carries.