Join us at Google I/O from May 18 to 20 for discussions, learning, and a first look at our latest developer products. Register now.

Create item list

Action ID

Construct a new list of items. Populate the list name and description using the and itemList.description intent parameters. Add a first item to the list using the parameter, if available.

We also recommend integrating our partner solution enabling notes and list access through a native Assistant experience that works across a variety of Assistant-enabled devices.

Locale support

Functionality Locales
Preview creation using App Actions test tool en-US
User invocation from Google Assistant en-US

Example queries

The following fields represent essential information that users often provide in queries that trigger this built-in intent:

Other supported fields

The following fields represent information that users often provide to disambiguate their needs or otherwise improve their results:


Supported text values by field

Sample actions.xml

For information about the actions schema, read Create actions.xml.

Handle intent parameters as URL parameters

<?xml version="1.0" encoding="utf-8"?>
<!-- This is a sample actions.xml -->
  <action intentName="actions.intent.CREATE_ITEM_LIST">
    <fulfillment urlTemplate="myapp://custom-deeplink{?itemListName,description,itemListElementName}">
      <!-- Eg. itemListName = "Grocery List" -->
      <!-- (Optional) Require a field eg.itemListName for fulfillment with required="true" -->
      <parameter-mapping urlParameter="itemListName" intentParameter="" required="true" />
      <!-- Eg. description = "For December" -->
      <parameter-mapping urlParameter="description" intentParameter="itemList.description" />
      <!-- Eg. itemListElementName = "Milk" -->
      <parameter-mapping urlParameter="itemListElementName" intentParameter="" />

    <!-- Provide a fallback fulfillment with no required parameters. For example, to your app search or router deeplink -->
    <fulfillment urlTemplate="myapp://deeplink" />

JSON-LD sample

The following JSON-LD sample provides some example values that you can use in the App Actions test tool:

  "@context": "",
  "@type": "ItemList",
  "description": "For December",
  "itemListElement": {
    "@type": "ListItem",
    "name": "Milk"
  "name": "Grocery List"