---
title: KalturaCategory Object
url: https://docs.kaltura.com/docs/rich-media-cms-apis/content-management/categories-kalturacategory-object
---

## KalturaCategory Object


Every category in a Kaltura partner account is a `KalturaCategory`:

| Field | Type | Description |
|-------|------|-------------|
| `id` | integer | Auto-generated category ID (read-only) |
| `name` | string | Category display name |
| `parentId` | integer | Parent category ID (`0` for root-level categories) |
| `fullName` | string | Full path from root (e.g., `"Media>Training>Onboarding"`) (read-only) |
| `fullIds` | string | Full ID path from root (e.g., `"12>45>78"`) (read-only) |
| `referenceId` | string | External reference identifier |
| `description` | string | Category description |
| `tags` | string | Comma-separated tags |
| `depth` | integer | Depth in the hierarchy (`0` for root) (read-only) |
| `entriesCount` | integer | Number of entries assigned (read-only) |
| `directEntriesCount` | integer | Entries assigned directly (not via subcategories) (read-only) |
| `directSubCategoriesCount` | integer | Number of immediate child categories (read-only) |
| `membersCount` | integer | Number of category members (read-only) |
| `status` | integer | Category status (see below) |
| `privacy` | integer | Privacy level (see below) |
| `privacyContext` | string | Privacy context label for entitlement |
| `privacyContexts` | string | Comma-separated list of privacy context labels |
| `appearInList` | integer | Who can see this category in listings (see below) |
| `contributionPolicy` | integer | Who can assign content (see below) |
| `inheritanceType` | integer | `1` = INHERIT from parent, `2` = MANUAL |
| `userJoinPolicy` | integer | How users can join (see below) |
| `defaultPermissionLevel` | integer | Default permission for new members |
| `moderation` | integer | `1` = entries require approval before activation |
| `owner` | string | Owner user ID |
| `partnerId` | integer | Partner ID (read-only) |
| `createdAt` | integer | Unix timestamp (read-only) |
| `updatedAt` | integer | Unix timestamp (read-only) |
| `objectType` | string | Always `"KalturaCategory"` (read-only) |

### Category Status Values

| Value | Name | Description |
|-------|------|-------------|
| 1 | UPDATING | Category is being updated (tree restructuring in progress) |
| 2 | ACTIVE | Normal active category |
| 3 | DELETED | Soft-deleted |
| 4 | PURGED | Permanently removed |

### Privacy Levels (KalturaPrivacyType)

| Value | Name | Description |
|-------|------|-------------|
| 1 | ALL | Content is visible to everyone with access to the application |
| 2 | AUTHENTICATED_USERS | Content is visible to authenticated users only (KS with `userId`) |
| 3 | MEMBERS_ONLY | Content is visible only to category members and content owners |

### Contribution Policy (KalturaContributionPolicyType)

| Value | Name | Description |
|-------|------|-------------|
| 1 | ALL | Any user can assign content to this category |
| 2 | MEMBERS_WITH_CONTRIBUTION_PERMISSION | Only members with CONTRIBUTOR permission or higher |

### Appear In List

| Value | Name | Description |
|-------|------|-------------|
| 1 | PARTNER_ONLY | Visible to all partner users |
| 3 | CATEGORY_MEMBERS_ONLY | Visible only to category members |

### User Join Policy (KalturaUserJoinPolicyType)

| Value | Name | Description |
|-------|------|-------------|
| 1 | AUTO_JOIN | Users can add themselves to the category |
| 2 | REQUEST_TO_JOIN | Users can request to join; requires moderator approval |
| 3 | NOT_ALLOWED | By invitation only; users cannot request to join |