ECOMMERCE datasets and schemas - Amazon Personalize
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).

ECOMMERCE datasets and schemas

When you create a Domain dataset group for the ECOMMERCE domain, each dataset type has a default schema with a set of ECOMMERCE-specific required and recommended fields. You can use the default schema or create a new one based on the default schema. The data you import must match your schema in format and type. Use the default domain schemas listed in the sections below as a guide to determine what data to import to create your ECOMMERCE-based recommender.

You are free to add additional fields. As long as the fields aren't listed as required or reserved, and the data types are listed in Schema data types, the field names and data types are up to you.

For information about general Amazon Personalize schema requirements, such as formatting requirements and available field data types, see Schemas. These requirements apply to all schemas, regardless of domain.

The following topics provide information about each dataset's required and recommended fields for the ECOMMERCE domain. Each dataset section includes the default ECOMMERCE schema in JSON format.

ECOMMERCE domain dataset and schema requirements

Each dataset type has the following required fields and reserved keywords. Reserved keywords are optional, non-metadata fields. These fields are considered reserved because you must define the fields as their required data type when you use them. Reserved categorical string fields must have categorical set to true, while reserved string fields can't be categorical. The keywords can't be in your data.

Dataset type Required fields Reserved keywords
Item interactions (default schema)

USER_ID (string)

ITEM_ID (string)


EVENT_TYPE (string and depending on use case, Purchase and View event types)

EVENT_VALUE (float, null)

IMPRESSION (string, null)

RECOMMENDATION_ID (string, null)


Users (default schema)

USER_ID (string)

1 metadata field (categorical string or numerical)

Items (default schema)

ITEM_ID (string)

PRICE (float)

CATEGORY_L1 (categorical string)

CATEGORY_L2 (categorical string, null)

CATEGORY_L3 (categorical string, null)

PRODUCT_DESCRIPTION (textual string, null)


AGE_GROUP (categorical string, null)

ADULT (categorical string, null)

GENDER (categorical string, null)