Unit Detail

What it’s for

While a Unit is the physical record, Unit Detail is its commercial listing: price, specs, images, and whether it’s publicly visible. A unit has at most one. This is the only place that can make a unit For Sale or For Rent — see Units for why.

Where to find it

On a unit’s own detail page, under Housing → Units. There’s no separate menu item — you get here by opening a unit.

Who can use it

• See the listing — needs view and get.
• Create, edit, delete the listing — needs create/update/delete, each a separate permission from the base unit’s own.

How to…

Create a listing

1. Open the unit and start a new listing.
2. Choose For Sale or For Rent.
3. Set the matching price — sale price if For Sale, rent price if For Rent. Whichever you pick is required.
4. Optionally set a discount price — it can’t exceed the sale price.
5. Fill in area, bedrooms, bathrooms, garage, floors, and electricity capacity.
6. Pick a marketing contact — this is who inquiries route to.
7. Add images, a video link, a brochure, and a description.
8. Decide whether to publish it now or save as unpublished.
9. Save. This also updates the unit’s own status to match.

Publish or unpublish a listing

1. Open the listing and toggle publication.
2. Save.

Delete a listing

1. The listing must be unpublished first, and the unit’s own status must be moved off For Sale/For Rent — deletion is blocked otherwise.
2. Once those are cleared, delete.

Field reference

Field	Required	Notes
Listing type	Yes	For Sale or For Rent
Sale price	If For Sale
Rent price	If For Rent
Discount price	No	Cannot exceed the sale price
Area, bedrooms, bathrooms, garage, floors, electricity	No
Marketing contact	Yes	Who public inquiries reach
Images, video link, brochure, description	No
Published	No	Gates public visibility, together with the cluster

Rules & statuses

Publishing this listing doesn’t guarantee it’s publicly visible. A listing only shows up on the public marketplace when every one of these is true at once:

• The listing itself is published.
• Its cluster is published (Housing Cluster).
• The developer’s own account is published.
• It has a price set.
• The unit hasn’t already sold.

If any of those isn’t met, the public page reports exactly which one instead of just hiding the listing — worth checking there first if a listing “isn’t showing” and everything here looks right.

Saving a listing updates the unit’s own status to match, but this sync is best-effort — if it fails, the listing is still saved, and the mismatch resolves on the next save rather than being retried automatically.

Related pages

• Units — the base record a listing belongs to, and why listing statuses can’t be set there directly.
• Housing Cluster — must be published for any of its listings to be publicly visible.
• Marketing Contact (Settings) — where the contacts selectable here are managed.
• See the full marketing & sales flow → — from this listing being built to a buyer submitting an enquiry on the public page.