Entity the custom field applies to. Immutable after creation.
SalesOrder / SalesOrderRow — the field lives on a sales order, or on one of its rows.
ProductVariant / MaterialVariant / ServiceVariant — the field lives on an item. In Katana these are the Products, Materials, and Services an item can be. Values are held per variant, not on the product / material / service itself: a ProductVariant definition is set and read on each of a product’s variants, and a product with one variant simply has one place to set it.
PurchaseOrder / PurchaseOrderRow / OutsourcedPurchaseOrder / OutsourcedPurchaseOrderRow — the field lives on a purchase order, standard or outsourced, or on one of its rows.
ManufacturingOrder — the field lives on a manufacturing order. A variant definition can also reach manufacturing orders through appearsOn.
ProductionOperation — the field lives on a production operation.
RecipeBom — the field lives on a BOM row. The same definitions are used on manufacturing order recipe rows and outsourced purchase order recipe rows.
Supplier — the field lives on a supplier.
Customer — the field lives on a customer.
Two groups each share a single pool of definitions, so a definition is accepted beyond the exact entity type it was created with:
- The three variant entity types — a definition created with any one of them is accepted on any variant, whatever kind of item it belongs to.
- Standard and outsourced purchase orders —
PurchaseOrder and OutsourcedPurchaseOrder definitions are both accepted on any purchase order, and likewise PurchaseOrderRow / OutsourcedPurchaseOrderRow on any purchase order row.
Katana’s own UI still scopes each definition to the item type or kind of order it was created for, so pick the entity_type that matches where you want the field to appear. The 100-definition limit is still counted per entity_type, not per group.
During the beta, entity types other than SalesOrder and SalesOrderRow are available when the account turns on Custom fields in Katana Labs. ProductionOperation and ManufacturingOrder additionally require the Advanced Manufacturing or Manufacturing Management add-on. Without access, the request is rejected with a 403.