When you use structured data to mark up items for lists, you make your content eligible for inclusion in a sequence-based UI in Search. Users can easily swipe or scroll through a list of cards showing a preview of your site from their Search results, which leads them more quickly to the right content on your site. Lists show up in Search results in two types:
- Host-specific lists display cards from a single site within a specific category. This markup uses a combination of ItemList markup and individual data type markup to enable a carousel of lists to appear in Search.
- Events also appear as a list under results from authoritative event websites.
Mark up host-specific lists
Build your list pages with AMP HTML and use two types of markup to make your content eligible for a host-specific list:
- List Page markup—this markup specifies the list, its items, and their order.
- Item-specific markup—this markup notes the properties for the
data type you want to have in the list, such as
Provide markup for the
ItemList data type by using these required properties.
|itemListElement (Required)||ListItem||Annotation for a single item page.|
|ListItem.position (Required)||Integer||Ordinal position of the item page in the list.|
|ListItem.url (Required)||URL||The canonical URL of the item page. Every item should have a unique URL.|
Data type markup
To enable host-specific lists, you first expose the data type properties you want to make available for presentation in your list, such as an image, a description, and other relevant details. Mark up each item in the list (i.e., recipe, movie, or restaurant listing) with the required structured data markup. While the requirements are minimal, you can include recommended markup to enhance the appearance in the search result. Check the documentation for each data type to see the specific requirements.
How to mark up host-specific lists
Mark up your lists in two ways:
- Separately—When a recipe has its own page, use data type markup on individual item pages. Use list page markup on the summary page that links out to the items. If you use this method, the visible content on the summary page must contain the same content that you specify in the markup, such as your site’s listing of user’s favorite dinner recipes. See Structured data guidelines in Introduction to Structured Data for specifics.
- Combined—When multiple recipes are on a single page, use list page markup that both
itemizes the data types and exposes their properties in the
In this case, be sure to include a unique URL for each item, which in this case might include an anchor tag.
The examples below open markup in the Structured Data Testing Tool for
Recipe and list markup