Catalogue kinds
Reference of every catalogue kind and where it's used.
The catalogue ships with eight default kinds. Workspaces can also add their own for anything the team wants as a reusable autocomplete source, e.g. Hardware Style or Trim Profile. Each kind powers different fields in different categories.
Default kinds
| Kind | Used by | Examples |
|---|---|---|
| brand | Most categories with a brand column | Kohler, Moen, Delta, Sherwin-Williams |
| model | Categories with a model column | Cimarron, Trinsic |
| colour | Plumbing finish, Cabinets colour, Paint colour, Lighting fixtures, Mirrors, Railings, etc. | Matte Black, Brushed Nickel, Polished Chrome, Eggshell White |
| finish | Hardware-heavy categories | Brushed, Polished, Antique |
| size | Categories with a size column | 36in, 48in |
| sink_config | Plumbing only | Single Bowl, Double Bowl, Undermount Single |
| flooring_type | Flooring & Tile only | Hardwood, LVP, Porcelain Tile, Carpet |
| room | Wherever a room reference is needed | Master Bathroom, Powder Room, Main Kitchen |
How a kind gets used
Each spec category's schema decides which standard fields are autocomplete-backed and which kind they pull from. For example:
- Plumbing → Finish/Colour uses
colour. - Plumbing → Single/Double uses
sink_config. - Flooring → Type uses
flooring_type. - Appliances → Brand uses
brand.
The wiring of standard fields is fixed by the schema. Custom autocomplete columns work differently: when you add a custom column and pick the Autocomplete type, you choose which kind (default or custom) it pulls from.
Adding custom kinds
Open the Catalogue page and use + Add Category in the sidebar (or chip rail on mobile). Give it a label and a description. The internal key is generated from the label and you can ignore it. See manage entries.
Adding entries to a kind
Two ways:
- Inline, type a new value into a sheet field that's autocomplete-backed. When nothing matches, a Create New option appears in the dropdown. Pick a kind and the value is added on the spot.
- From the catalogue page, open the category you want to add to and click + Add value. Useful for pre-loading values before a project uses them.
Naming consistency
Keep entries canonical:
- Use one casing (Brushed Nickel, not brushed nickel).
- Avoid spelling variants (Sherwin-Williams with the hyphen, consistently).
- Use full words rather than abbreviations where possible.
This is the whole point of the catalogue, once a value's canonical form is in there, autocomplete makes the right choice the easy choice.