# Property-Based Segmentation

> Source: https://docs.recombee.com/segmentations/property-based-segmentations

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

# Property-Based Segmentation

Property-based Segmentation groups the Items by the value of a particular property.

`NULL` values are ignored.

## Examples

Consider the following data about the Items:

### Example 1

Segmentation based on the _country_property (of type `string`) will create the following three Segments:

For example, the value of the _country_property for the _it\_crowd_ is `GB`, and therefore the _it\_crowd_ belongs to the`GB` Segment.

### Example 2

Segmentation based on the _genres_ property (of type `set`) will create the following three Segments:

Note that an Item can belong to multiple Segments: In that case, _the\_silence\_of\_the\_lambs_ belongs to both`Horror` and `Thriller` Segments.

## Creating in the Admin UI

[![You can create the Property-based Segmentation in the Admin UI by picking the name of the property](/img/segmentations/admin_ui_property_based.png)](/img/segmentations/admin_ui_property_based.png)

You can create the Property-based Segmentation in the Admin UI by picking the name of the property

* Navigate to the _Segmentations_ section
* Create a new Segmentation of the _Property-based_ type and select by which Item property the Items shall be segmented.
* Check the preview of the resulting Segments and confirm the setup

## Creating via the API

* Call the [Create Property Based Segmentation](/api/segmentations#request-create-property-based-segmentation) endpoint.