Inventory stages & colours
What it's for
Inventory stages describe where each unit sits in your sales process — Available, Hold, Sold, and any steps you add such as Reserved or Under negotiation. Each stage has a colour that tints the unit on the public map, the sales layout and the inventory list, so anyone can see availability at a glance. Changing a unit's stage is the everyday job of the sales team.
Before you start
- Adding and editing stages needs permission to manage inventory or to edit the project's settings.
- Changing a unit's stage needs permission to manage inventory.
Default stages
Every new project starts with three stages:
| Stage | Colour | Counts as |
| Available | None (unit shows the plan underneath) | Available |
| Hold | Orange | On hold |
| Sold | Red | Sold |
Default stages can be renamed and recoloured, but not removed.
Add or edit a stage
- Open the project and its Inventory stages tab.
- Enter a Custom stage name (for example "Under negotiation") and pick a colour. Use the opacity slider or quick picks so unit numbers stay readable through the colour; a solid colour can hide them.
- Press Add stage.
- To change a stage, press Edit, change the name or colour (or choose no colour), and Save.
- To remove a custom stage, press remove and confirm. Units using it move to Available.
Change a unit's stage
- Inventory list — the stage dropdown on each row, or select rows and use Bulk update stage.
- Sales layout — tap the unit, change Inventory stage, Save changes. See Sales layout.
- Unit form — the Stage field.
- Upload page → Bulk update — for a list of unit numbers. See Bulk update units.
- CSV import — the
stage_name column, spelled exactly as the stage.
- API — with an inventory write key. See API keys.
What happens automatically
- Map colours change without republishing: the sales layout straight away, the public map on its next load.
- Each change is recorded in the unit's history with who made it and from where.
- If your company requires approval for booking or selling a unit, the unit shows Pending approval until the change is approved.
- When the sales modules are in use, holds and bookings set the stage for you.
Custom stages and availability
A custom stage counts as available for features that look at availability — for example the Enquiry Now button on the public map and availability counts. If a custom stage really means the unit is taken (such as "Booked"), consider renaming Hold or Sold instead, so buyers cannot enquire about it.
Tips and common questions
- Pick clearly different colours; sales staff scan the map, not the legend.
- Stage names in CSV files must match exactly, including capitals.
- Buyers see the stage name and legend only when Show availability status and Show map legend are on. See Public display settings.
- Ownership companies can have their own colour for each stage. See Ownership companies.
Related: Inventory basics · Sales layout · Stages, zones & structure