Sizecode Groupings allows operators to categorise their sizecodes into three dimensions: Type, Price Tier, and Size Tier. Operators manage groupings in Spaceman Desktop, while Spaceman Shop uses them to let occupiers filter available units during booking.
Sizecode Type and Price Tier previously existed only in Spaceman Link, available to customers building their own API integrations. They were not accessible through any Spaceman user interface. With this release:
- Desktop introduces a full UI for managing all three grouping categories for the first time, without needing SQL updates.
- Size Tier is a new dimension, added to support Shop filtering (not currently available for Link).
- Customers already using Type and Price Tier through Link can now manage them from Desktop as well.
Concepts
Each sizecode can be assigned to up to three grouping categories:
| Grouping | Purpose | Example Values |
|---|---|---|
| Sizecode Type | Classify by the nature of the storage unit | Unit, Container, Mailbox |
| Price Tier | Classify by pricing band | Budget, Standard, Premium |
| Size Tier | Classify by physical size range | Small, Medium, Large, Extra Large |
Groupings can be customised per site via Custom Settings, where one category can be designated as the "Main Filter" for use in the Shop.
Desktop Application (Released in 4.5.83)
Managing Grouping Definitions
A new Sizecode Groupings form under Settings allows operators to create, edit, and delete entries for each grouping table.
Assigning Groupings to Individual Sizecodes
Three new dropdown fields on the sizecode record allow assigning a Type, Price Tier, and Size Tier.
Bulk Operations
From the Sizecode Selector list, multi-select sizecodes (Ctrl+click or Shift+click) then:
- "Assign" button - assign selected sizecodes to a Type, Price Tier, or Size Tier via popup menu
- "Clear Group" button - remove a grouping assignment from selected sizecodes
Audit Tracking
All grouping changes are recorded in the SizecodeMovement audit table, visible on the sizecode form's movements grid.
Custom Setting
The sizecode grouping configuration is displayed in a read-only grid within the sizecode groupings form. The main filter setting can be configured globally or overridden per site. For operators with many sites, rows are grouped by those sharing the same setting value, keeping the display compact. To configure this, go to Settings, Custom Settings, Units/Sizecodes, 7. Group Sizecodes By
Spaceman Shop
Filter by Sizecode Grouping
The "Select Size" step in the booking flow now includes a "Filter By" panel. This displays filter options based on whichever grouping category the operator has set as the Main Filter in Custom Settings (e.g., if Type is the main filter, occupiers see options like "Unit", "Container", "Mailbox"). Selecting a value narrows the displayed sizecodes; clearing the filter shows all sizecodes again.
Unassigned sizecodes remain visible when no filter is selected.
End-to-End Example
- Desktop setup: Operator creates Type groupings (e.g., Unit, Container, Mailbox) and assigns each sizecode to the appropriate type
- Custom Settings: Operator sets "Type" as the main filter for their site
- Shop experience: When an occupier reaches the "Select Size" step, they see a filter panel with the options "Unit", "Container", and "Mailbox"
- Filtering: Occupier selects "Unit" and only unit type sizecodes are shown, making it faster to find the right one