User Documentation
API Clients & Integrations
Scenario Recipes
Table of contents
Property Roles
Property roles allow you to describe the semantic meaning of your item properties, enabling the recommendation engine to better understand and utilize your data.
Property roles are assigned when adding item properties.
Roles
Roles define the semantic purpose of a property. By assigning a role, you help the recommendation engine understand what kind of information the property holds and how to best use it.
Title
The primary human-readable name of the item.
ID
title
Data types
string
Summary
A short textual description of the item, providing additional context or details beyond the title.
ID
summary
Data types
string
URL
A canonical web address pointing to the item’s detail page or primary location, used for navigation and linking from user interfaces.
ID
url
Data types
string
Tags
A set of descriptive keywords or labels assigned to the item.
ID
tags
Data types
set
Categories
A set of categories describing the item’s placement within a taxonomy. Multiple values are allowed.
ID
categories
Data types
set
Cannot be used with
category
Category
A single primary category describing the item’s placement within a taxonomy.
ID
category
Data types
string
Cannot be used with
categories
Genres
A set of genres describing the content type or style of the item (e.g. drama, comedy, rock).
ID
genres
Data types
set
Available in domains
Video, Music & Podcasts
Cannot be used with
genre
Genre
A single primary genre describing the content type or style of the item (e.g. drama, comedy, rock).
ID
genre
Data types
string
Available in domains
Video, Music & Podcasts
Cannot be used with
genres
Primary image
The main visual representation of the item.
ID
primaryImage
Data types
image
imageList
Price
The monetary value of the item.
ID
price
Data types
int
double
Publish date
The timestamp indicating when the item was made publicly available.
ID
publishDate
Data types
timestamp
Available in domains
Articles, News & Media