> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pureclarity.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Category Recommender Model

> Model available for use in the Templates, and also returned by PureClarity in server-side requests

Model available for use in the Templates, and also returned by PureClarity in server-side requests

## Properties

<ParamField body="title" type="string">
  The title of the recommender
</ParamField>

<ParamField body="type" type="string">
  Set to "recommender-category"
</ParamField>

<ParamField body="items" type="array">
  Array of category objects to show in the recommender
</ParamField>

### Category Item Properties

<ParamField body="items[].Id" type="string">
  The category's unique Id
</ParamField>

<ParamField body="items[].DisplayName" type="string">
  The category name to show in the recommender
</ParamField>

<ParamField body="items[].Image" type="string">
  The url to the category image
</ParamField>

<ParamField body="items[].Link" type="string">
  A url link to take an optional category page
</ParamField>

<ParamField body="items[].Description" type="string">
  An optional description text
</ParamField>

<ParamField body="items[].Parents" type="array">
  An array of immediate parent category IDs
</ParamField>

<ParamField body="items[].Children" type="array">
  An array of immediate child category IDs
</ParamField>

<ParamField body="items[].AllChildIds" type="array">
  An array of ALL child IDs, not just immediate children
</ParamField>

## Example

```json theme={null}
{
  "title": "Popular Categories",
  "type": "recommender-category",
  "items": [
    {
      "Id": "3841",
      "DisplayName": "Electronics",
      "Image": "https://example.com/images/categories/electronics.jpg",
      "Link": "https://example.com/categories/electronics",
      "Description": "Latest gadgets and technology",
      "Parents": [],
      "Children": ["3842", "3843"],
      "AllChildIds": ["3842", "3843", "3844", "3845"]
    },
    {
      "Id": "3842",
      "DisplayName": "Smartphones",
      "Image": "https://example.com/images/categories/smartphones.jpg",
      "Link": "https://example.com/categories/smartphones",
      "Description": "Latest mobile phones",
      "Parents": ["3841"],
      "Children": ["3844", "3845"],
      "AllChildIds": ["3844", "3845"]
    }
  ]
}
```