Mark Up Your Lists

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 name and prepTime for recipes.

List markup

Provide markup for the ItemList data type by using these required properties.

Property Type Description
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 item field.

    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 ItemList markup.

List-only markup

Recipe and list markup

Recipe-only markup

Send feedback about...