---
url: https://developer.youcan.shop/themes/objects/category.md
---

# `category` object

Information about a product category.

### Properties

***

| Name                 |                            Type                             | Description                                                         |
| -------------------- | :---------------------------------------------------------: | :------------------------------------------------------------------ |
| `id`                 |              [string](../basics/types#string)               | Category identifier                                                 |
| `name`               |              [string](../basics/types#string)               | Category name                                                       |
| `title`              |              [string](../basics/types#string)               | Category name                                                       |
| `slug`               |              [string](../basics/types#string)               | Category slug                                                       |
| `handle`             |              [string](../basics/types#string)               | Category slug                                                       |
| `url`                |              [string](../basics/types#string)               | Path of the category page                                           |
| `description`        |              [string](../basics/types#string)               | Category description                                                |
| `image`              |              [string](../basics/types#string)               | Category image                                                      |
| `products`           | [array](../basics/types#array) of [product](product) object | The first 50 products, in the category's sort order. Use [paginate](../tags/paginate.md) for more |
| `products_count`     |              [number](../basics/types#number)               | Number of visible products in the category                          |
| `all_products_count` |              [number](../basics/types#number)               | Number of visible products in the category                          |
| `meta`               |               [array](../basics/types#array)                | Category meta                                                       |
| `metafields`         |               [array](../basics/types#array)                | Category metafields, by namespace and key. See [metafield](metafield) |
| `preview_image`      |          [preview\_image](preview_image) object or `null`    | The category image in several sizes, or nil when the category has no image |