# Property Roles

> Source: https://docs.recombee.com/api/property_roles_metadata

> For the complete documentation index, see [llms.txt](/llms.txt).

**Table of Contents & Filters**

DomainAllUniversalVideoMusic & PodcastsArticles, News & MediaData TypeAllStringSetImageImage ListIntegerDoubleTimestamp

**Table of Contents**
* [Roles](#roles)  
   * [Title](#title)  
   * [Summary](#summary)  
   * [URL](#url)  
   * [Tags](#tags)  
   * [Categories](#categories)  
   * [Category](#category)  
   * [Genres](#genres)  
   * [Genre](#genre)  
   * [Primary image](#primaryimage)  
   * [Price](#price)  
   * [Publish date](#publishdate)

# 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](/api#add-item-property).

## 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

Image List

#### Price

The monetary value of the item.

---

ID

price

---

Data types

Integer

Double

#### Publish date

The timestamp indicating when the item was made publicly available.

---

ID

publishDate

---

Data types

Timestamp

---

Available in domains

Articles, News & Media