---
title: "Category Schema"
canonical: "https://red-ant-documentation.refined.site/space/RDD/718766103/Category%20Schema"
format: markdown
---
> Macro (excerpt)
> 
> | **Field (* Required)** | **Definition** | **Format / Additional Info** |
> | --- | --- | --- |
> | `externalCategoryId` * | A "friendly", external-facing identifier for the category |  |
> | `name` * | The name of the product category | Alphanumeric string |
> | `image` | An accompanying category image which will display alongside the category name within the catalogue | Must be a publically accessible image URL |
> | `parentId` | The unique identifier of the parent category if this category is part of a hierarchy. If it is a top-level category, this value is null | No value ID needs to be set for parent categories |
> | `order` * | Determines the order in which categories are displayed in lists or menus. Categories with lower numbers appear first | The order is defined using numerical values, starting with `0` being the highest priority order |
> | `updateSource` | The last application to update the record | Alphanumeric string |
> | `details_otherCategoryId` | Fallback category if `externalCategoryId` doesn't exist |  |