# Categories

Products can be assigned to one or more categories which classify products into groups which could represent:

* Type of Product for example a "Toaster" category containing one or many Toasters.
* Products belonging to a special offer for example a "Special Deals" category contain one or many products with special pricing.
* Products assigned to be presented in a specific location within a channel, for example "Home Page Banner" for all products that are assigned to appear on a Banner on the Home Page of a website.

### Portal View

#### Accessing Categories 

Assess the **Categories** screen in the console via the console navigation bar.

<div align="left"><img src="https://3079805559-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LZA-vUHasjE__5Y0ghc%2F-M3p8K_j4TMVM7UxoVYL%2F-M3pBXcviqnuMdpuUvog%2Fimage.png?alt=media&#x26;token=f77538d7-db04-475b-a596-fca0b537b1e0" alt=""></div>

#### Add New Category

Specified a Name for the category.

Click **New Category** to create the new category.

<div align="left"><img src="https://3079805559-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LZA-vUHasjE__5Y0ghc%2F-M3p8K_j4TMVM7UxoVYL%2F-M3pBpaeP3e_dMrv0Eej%2Fimage.png?alt=media&#x26;token=f03c0c02-9c5c-4cec-ad1b-202bda13b382" alt=""></div>

#### Edit Categories

Additional **Category Details** can be specified including:

![](https://3079805559-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LZA-vUHasjE__5Y0ghc%2F-M3pD5lRq42ikh_Z9Rsm%2F-M3pDX5RcJKVuQGRjD1r%2Fimage.png?alt=media\&token=1995937c-cfcd-48de-87ca-0f31b6aeb0ba)

Click **Save** to commit your modifications.

### Category Properties

{% tabs %}
{% tab title="Attributes" %}

| Element         | Description                                                                                            |
| --------------- | ------------------------------------------------------------------------------------------------------ |
| categoryId      | Internal Identifier for the category                                                                   |
| name            | Name of the category                                                                                   |
| slug            | A Url slug to access the category                                                                      |
| description     | A Description for the category                                                                         |
| attributes      | One or more key/value pairs                                                                            |
| parent Category | A parent category to support the creation of a hierarchical/tree based structure of related categories |
| images          | Image (assets) assigned to a category                                                                  |
| {% endtab %}    |                                                                                                        |

{% tab title="Sample Object" %}

```
{
  "categoryId": "string",
  "version": "string",
  "slug": "string",
  "name": "string",
  "description": "string",
  "names": {
    "additionalProp1": "string",
    "additionalProp2": "string",
    "additionalProp3": "string"
  },
  "descriptions": {
    "additionalProp1": "string",
    "additionalProp2": "string",
    "additionalProp3": "string"
  },
  "parentId": "string",
  "parentName": "string",
  "itemCount": 0,
  "attributes": {},
  "children": [
    {
      "categoryId": "string",
      "name": "string",
      "slug": "string",
      "names": {
        "additionalProp1": "string",
        "additionalProp2": "string",
        "additionalProp3": "string"
      }
    }
  ],
  "totalChildren": 0,
  "sibling": [
    {
      "categoryId": "string",
      "name": "string",
      "slug": "string",
      "names": {
        "additionalProp1": "string",
        "additionalProp2": "string",
        "additionalProp3": "string"
      }
    }
  ],
  "totalSibling": 0,
  "isActive": true,
  "files": [
    {
      "fileId": "string",
      "contentType": "string",
      "accessPermission": "string",
      "accessUrl": "string",
      "attributes": {},
      "edgeUrl": "string"
    }
  ]
}
```

{% endtab %}
{% endtabs %}