Unit detail page

Everything about one apartment on a single, customizable page.

Last updated: 2026-05-10

The unit detail page at /units/[id] is where one apartment's full story lives — current rent and status, every lease that has ever been signed there, photos, amenities, the comp report, internal comments, and the audit trail. You land here from any unit cell on /inventory, from search, or from the deals kanban.

Why this matters

The Inventory Table is for scanning hundreds of units at a glance. The unit detail page is for working on one. When you need to record a new lease, change the status, flag the unit for a photo shoot, or pull a comp report to send to the landlord — this is the page.

Customizable section layout

You can drag the sections on this page into the order you prefer, hide the ones you do not need, and your layout follows you across browsers and devices.

1. Click Customize layout in the top-right of the page.
2. The page enters a drag mode — each section sprouts a drag handle.
3. Drag sections up or down to reorder. Use the eye icon on a section to hide it. Hidden sections live at the bottom of the customize panel and can be brought back at any time.
4. Click Save layout. Or click Reset to go back to the default.

Your saved layout is per-user. The agent who works rentals heaviest in the building can put the lease history first; an admin who triages photo shoots can put photos at the top.

Default section order

Out of the box, sections appear in this order:

1. Top metrics — current rent, regulation, occupancy snapshot.
2. Rent cap — the legal ceiling for this unit (RGB / HCR / GCE) and how much room you have under it.
3. Relist — the marketing-state controls (advertised flag, listing channels).
4. Comp report — how this unit compares to similar units in the building, the zip, and across the city. See the comp report page.
5. Details — beds, baths, square footage, floor, etc.
6. Amenities — what the unit and building offer.
7. Leases — past tenancies on this unit.
8. Photos — the unit's photo set.
9. Exposures — every channel this unit has been listed on (StreetEasy, Compass, Zillow, etc.).
10. Comments — the internal thread for this unit.
11. Status log — the append-only history of every status change.

Each section is its own boundary. If one section ever fails to load, the rest of the page still works — only the broken section is replaced with a small inline empty state.

Editing the unit

The unit's editable fields (description, beds, baths, square footage, floor, lease term, amenities, internal notes, StreetEasy URL, landlord code, and so on) live in an Edit unit sheet that slides out from the right when you click the button next to "Get rent suggestion" at the top of the page. It is not an inline form on the page — keeping the read view clean was a deliberate choice.

For bulk edits across many units, use EO mode on /inventory instead.

Changing status

The status selector is in the top metrics area. Click it to pick a new status (vacant, occupied, rented, hold, and so on). Some transitions trigger automatic follow-ups:

• Moving a unit to rented or occupied automatically clears the advertised flag if it was on.
• Moving a unit into submitted, approved, or leases_out spawns a deal on the deals kanban if one does not already exist.
• Status notifications fire to whichever recipients your brokerage configured at /settings/notifications.

The Status log at the bottom of the page is append-only. Every transition shows up there with the timestamp, who did it, and how long the unit sat in the previous status. Nothing is ever overwritten.

Photos

The Photos section shows every active photo on the unit. To upload:

1. Click Upload photos on the Photos section.
2. Drag image files in or click to pick them.
3. After upload, each photo asks for a shoot type tag — listing (the marketing set), appraisal, inspection, or other. Tagging is optional but makes the comp-report and listing exposures cleaner.

If the unit is flagged needs photos, a photographer in your brokerage with a building assignment can upload as well. Routine agent uploads do not require the flag — the flag specifically tells a professional photographer that this unit is queued for a real shoot.

Amenities

Amenities are inherited from the building and extended on the unit. If the building is tagged with doorman and elevator, every unit in that building shows those amenities automatically. The unit can add more (dishwasher, balcony) without re-typing the building ones.

The amenity chips on this page tell you which amenities came from the building and which were added on the unit, so you know where to edit each one.

Leases

The Leases card is a compact summary strip on top — the current or most recent tenancy in one line — with a Show all disclosure underneath that expands the full lease history.

The lease history is append-only. When a tenant moves out and a new one moves in, the prior lease row stays in place forever; the new one is added below it. To record a new lease, click Record lease, fill in the sheet that opens, and submit. Urbero runs the proposed rent through the rent-cap gate before it commits.

Comments thread

The Comments section is the longer-form discussion thread for this unit. Anyone in your brokerage can post (up to 280 characters per comment). The thread supports:

• @-mentions — type @ and Urbero pops up a list of teammates in your brokerage. Pick one and they get a notification in their /inbox.
• Audience scope — by default comments are Internal brokerage (landlords and photographers do not see them). Switch to All viewers if you want a landlord-facing note.
• Correction replies — typos do not get edited in place. You post a child reply with the fix; the original stays as the audit trail.
• Suggested rent — a typed comment with a structured dollar value that surfaces in the Inventory Table's Suggested rent column.

The Inventory Table notes column shows the last two comments from the past 90 days on hover. The full thread lives here.

When to use the comp report

If a landlord asks "what should we list this for?" or "is our rent in line with the market?" — that is the comp report. It compares this unit's rent and time-on-market against six different scopes (same building, same zip + bed count, PSF per year, days on market, concession patterns, HUD FMR). It is also exportable as a PDF that admins can email to the landlord.

See also

• Custom Inventory Table — the list view that feeds this page.
• EO mode — bulk-edit grid alternative.
• Comp report — pricing analysis section in detail.
• Leases — the append-only tenancy history that lives in the Leases section.
• Deals — the funnel record that auto-spawns when a unit moves into submitted / approved / leases_out.
• Comments — the unit-scoped discussion thread, including @-mentions and audience scope.