Skip to content

Schemas and fields

Model your products with a schema of typed fields and tell the matcher which of them matter.

Your catalogue is schema based. Every product carries a small set of core fields that exist on every schema (sku, title, category, uom, price, currency, stock_qty and lead_time_days) plus the attributes you define for that product family.

Kabaido ships eight domain preset schemas, for example a cutting tools schema. Each preset is created as an editable copy in your organisation, so you can change it freely. You can also build a custom schema from scratch in the Schemas tab, adding and reordering fields with a live preview of the product form and facet rail.

Field types

A field has a key (snake_case, for example diameter_mm), a label and a type. The available types are number, text, select, boolean and dimension. Number and dimension fields carry a canonical unit. Select fields carry a list of options. Any field can hold synonyms (for example dia, d1) which feed automatic header mapping on import and attribute mapping in extraction. Mark a field as a facet to show it in the browse facet rail, or as required.

Match roles

Each field can be given a match role that controls how it behaves when an incoming request is matched against your catalogue.

RoleBehaviour
hardMust satisfy the requested value for a product to be a candidate. Used for attributes that cannot be substituted.
softInfluences ranking with a weight but does not exclude a product. Used for preferences.
ignoreNot used in matching.

Numeric and dimension fields can also set a tolerance with a toleranceMode of abs or pct, and nearestAbove where a result must meet or exceed the requested value. This is how a requested diameter is matched to the nearest stocked size within an acceptable band. Soft fields carry a weight, defaulting to 5, that sets how much they count in the fit score. Equivalence pairs, such as TiAlN and AlTiN for coating, can be declared so that either value satisfies the other as an acceptable alternative.

10 mm endmill TiAlN

HX4F-010-TA

10 mm 4 flute square endmill TiAlN

Match
⌀10 mm4 flutesTiAlN

Unit price

£51.87unit

Add to quote
Live preview: browsing a schema based catalogue with facets built from your own fields.

Schema changes are additive only. Removing a field archives it and the underlying data is preserved in the product attributes, so no history is lost.