A store category: one node of a store's browse tree. Each category belongs to a store through its Store field and can nest under a Parent Category. Catalogue entries (Store Category Items) are created inside a category and name the items the store sells. The web and mobile Product Catalogue, the mobile selling scope and storefront publishing all collect a store's categories by their Store field only, so a category with no Store is in no store's range, whatever its parent. The catalogue's category filter shows the tree alphabetically by display name (Label if filled, otherwise Name), counts include subcategories, and a category whose parent is not in the store is shown as a top-level category. Show In Catalog narrows only that filter: while no category of the store has it switched on, every category is offered; once one has it, only categories whose whole parent chain has it are offered. Products in hidden categories still appear under All, in the selling scope and on the storefront. Categories have no menu entry and are managed on the store's Related tab. Only Name is required, there is no numbering, no validation and no duplicate check. Clone copies the category record only; Delete leaves its entries and subcategories in place.
Fields
| Field | Label | Type | Required | What it does |
|---|
CatalogueId | Product Catalogue | Lookup → ProductCatalogue | | Link to a Product Catalogue (filter settings) record. Not read by the catalogue, the selling scope or the storefront; a store's filter settings are found through the store itself. |
CreatedById | Created By | Lookup → UserAccount | Yes | |
CreatedDateTime | Created Date | DateAndTime | Yes | |
CurrencyIsoCode | Currency ISO Code | Text | | A currency code on the category. Not read by the catalogue or storefront publishing, which use the store's own Currency ISO Code. Shown only on the category's hover preview. |
ExternalId | External | Text | | An identifier from another system, for imports and integrations. Not used by the catalogue or the storefront. |
Id | Id | Guid, hidden | Yes | |
Label | Label | Text | | Optional display name. When filled it replaces Name in the web and mobile catalogue filter and becomes the storefront category name and the basis of its web address. Not on the shipped forms. |
ModifiedById | Modified By | Lookup → UserAccount | | |
Name | Name | Text | Yes | Required name of the category, shown in the store's category list and, when Label is empty, as the category's name in the catalogue filter and on the storefront. Not unique. |
OwnerId | Owner | Lookup → UserAccount | | The user who owns the record. A column in the shipped Store Category related-list view. It does not affect which partners see the category. |
ShowInCatalog | Show In Catalog | Boolean | | Whether the category is offered in the web and mobile Product Catalogue's category filter. Off by default. While no category of the store has it on, every category is offered. Once any category has it on, only categories whose whole parent chain has it on are offered. It never hides products: they still appear under All, in the mobile selling scope and on the storefront, which ignores this switch. |
StoreCategoryId | Parent Category | Lookup → StoreCategory | | The parent category. Leave it empty for a top-level category; fill it to nest this category beneath another. The lookup is not limited to the same store, so pick a parent from the category's own store. Selecting a parent in the catalogue filter also selects all its subcategories. If the parent is deleted or belongs to another store, this category is shown at the top level. |
StoreId | Store | Lookup → Store | | The store this category belongs to. Filled in automatically when the category is created from the store's Related tab. This field alone decides store membership: a category with no Store, or another store, is not part of this store's catalogue, selling scope or storefront, even if its parent is. |
UpdatedDateTime | Modified Date | DateAndTime | Yes | |
Actions
| Action | Label | Type | What it does |
|---|
Clone | Clone | ServerAction (Clone) | Create a copy of this record |
Delete | Delete | Delete | Delete |
DeleteEntity | Delete | Delete | DeleteEntity |
DeleteRow | Delete | Delete | DeleteRow |
Edit | Edit | Edit | Edit |
EditEntity | Edit | Edit | EditEntity |
EditInLineEntity | Edit | EditInline | EditInLineEntity |
EditRow | Edit | Edit | Edit Row |
New | New | New | New |
