Units
Manage residential units, their cluster, occupancy status, and construction progress.
What it’s for
Every physical property record — its code, type, cluster, and current status — is a Unit here. This is the base record everything else (residents, listings, guests, bills) ultimately points back to.
Where to find it
Sidebar → Housing → Units, at /admin/housing/units. Opening a unit goes to its detail page, which also hosts its commercial listing — see Unit Detail.
Who can use it
- See the menu item and open the page — needs view.
- See the unit list — needs get.
- Create, edit, delete a unit — needs create/update/delete.
On this screen
A table of units for the current cluster, with create, edit, and delete actions.
How to…
Add a unit
- Click create.
- Enter its code, type, and cluster.
- Set its status.
- Optionally add a cover image, and a warranty date and handover date.
- Save.
Edit or delete a unit
- Open the edit or delete action on its row.
- For edit, change any field. For delete, confirm.
Log construction progress
- Open a unit’s detail page.
- Add a progress entry: a title, description, a percentage, and a status (In Progress, Finished, or On Hold), with optional photos.
Field reference
| Field | Required | Notes |
|---|---|---|
| Unit code, unit type, cluster | Yes | |
| Status | Yes | See lifecycle statuses below |
| Warranty date, handover date | No | |
| Progress entries | No | Logged separately from the unit’s own status |
Rules & statuses
| Status | Meaning |
|---|---|
| Available | Not occupied, not listed |
| Under Development | Still being built |
| Occupied | A resident lives here |
| Vacant | Not currently occupied |
| For Sale / For Rent | Has an active listing — see Unit Detail |
| Sold | Sale closed |
You can’t set For Sale or For Rent directly on this form. Those two only happen by creating a listing on the Unit Detail page — this keeps a unit from ending up listed without the pricing and marketing data a listing actually needs. Closing a sale moves status to Sold; a listing that led to that sale stays recorded as For Sale on its own record, since a listing records intent, not the outcome.
There’s a third, separate status you’ll see elsewhere but not here: a unit’s sales funnel state (Available / Reserved / Sold), written only by Sales Activity as a deal moves through its stages — it isn’t part of this form.
Related pages
- Unit Detail — the commercial listing for a unit; the only way to make it For Sale or For Rent.
- Housing Cluster — the cluster a unit belongs to.
- Sales Activity — the source of a unit’s sales funnel state.