Unit Rental Visibility
Unit Rental Visibility
Block management staff need to know whether a unit is being let before contacting the owner directly. For example, when raising a noise complaint or a maintenance issue against a unit that is tenanted, the correct first contact is the letting agent — not the owner.
This feature gives staff immediate visibility into rental status at both the development level and the individual unit level.
Development Detail Page
The units table on the development detail page includes a "Rental" column.
- Units with an active rental link show a purple badge containing:
- A key icon
- The data source:
agentOS(synced automatically) orLet(manually flagged) - The letting agent name (if recorded)
- Hovering over the badge shows a tooltip with the letting agent's full contact details.
- Units with no active rental link show a dash (
—).
Rental data for all visible units is loaded in a single batch request, so adding the column does not increase page load time.
Unit Detail Page
When a unit has an active rental link, a prominent purple banner is displayed at the top of the unit detail page:
🏠 This unit is being let — Contact the letting agent before reaching out to the owner directly.
Rental Details Shown
| Field | Description |
|---|---|
| Letting agent name | The agency managing the letting |
| Contact person | Named contact at the agency |
| Phone | Letting agent phone number |
| Letting agent email address | |
| Tenant name | Current tenant |
| Tenancy start | Date the tenancy began |
| Tenancy end | Expected or actual end date |
| RTB registration number | Residential Tenancies Board registration (Irish compliance) |
| Monthly rent | Agreed monthly rent amount |
If the rental link was synced from agentOS, a source badge and last sync timestamp are shown alongside the details.
Managing Rental Links
When a rental link is active:
- Click Edit to update letting agent or tenancy details.
- Click End to close the rental link. The record is retained in history with an ended timestamp.
When no rental link is active:
- Click "Flag this unit as let" to manually create a rental link and record the letting details.
Rental History
A toggle on the unit detail page reveals the full rental history for the unit — all past active and ended records in chronological order.
Data Sources
Rental links can come from two sources:
| Source | How it's created |
|---|---|
agentOS | Synced automatically from agentOS integration |
manual | Created by a staff member directly in BlockManOS |
Both sources use the same underlying data model and display identically, except agentOS-sourced links show a source badge and sync timestamp.
Permissions
| Action | Required role |
|---|---|
| View rental status (development list, unit page) | Organisation member |
| Create rental link | Admin |
| Update rental link | Admin |
| End rental link | Admin |
| View rental history | Organisation member |
Irish Compliance — RTB Registration
The unit_rental_links table includes an RTB registration number field. This supports compliance with the Residential Tenancies Act — all private residential tenancies in Ireland must be registered with the Residential Tenancies Board (RTB). Recording the RTB number directly against the unit keeps this information accessible to management staff without needing to leave the platform.