Skip to main content

Tenants

First-time workspace setup

Open Tenants as setup step 15 after Bookings (step 14) and Listings (step 13) — complete Getting Started — Recommended Setup Sequence steps 1–12 first. Requires Tenants module permission (tenants.module). After go-live, pair With Debt triage with Finance and Handling a Late Payment.

Finding your way in this guide

Open Access Path and Interface overview for toolbar filters, then use Core Workflows — especially With Debt triage paired with Finance. Segment with tenant category filter like Bookings and Finance. Guide subsection map: Tenants guide subsection index (directory, profile, and segment sections + Related subsections). Habit-specific shortcuts live under Related below.

The Tenants module gives your team a tenant-first workspace for day-to-day follow-up. Instead of starting from a booking, you can search and segment your full tenant base, open a tenant profile, and review bookings, payment plans, and transaction history from one place.

Pair with other modules

Jump to reservations in Bookings; triage With Debt in Finance Contract Values. During month-end With Debt triage alongside Portfolio KPI review — Step 7, poll AI usage API (landlord_chat) when teams leaned on AI Chat for debtor lookups — there is no in-app ledger screen yet

Access Path​

In the current product navigation, the Tenants sidebar entry is grouped with Listings and Bookings in the Portfolio section. See Deep Links for all management frontend routes.

Ask AI Chat where to open Tenants

Not sure which Portfolio item holds people search and per-person debt? Ask AI Chat “Where do I open Tenants to find a person, see their bookings, and review debt across stays?” — then open Portfolio → Tenants (ai-chat-product-context-tenants-reply.png, ai-chat-product-context-tenants-flow.mp4). The assistant may say left menu without naming Portfolio. Portfolio-wide debt stays on Finance; reservation-first work stays on Bookings.

Need the person-first directory — search, segment, and per-person debt across stays (not a single reservation in Bookings, and not portfolio-wide ledgers on Finance)? Ask AI Chat “Where do I open Tenants to find a person, see their bookings, and review debt across stays?” — then open Portfolio → Tenants (ai-chat-product-context-tenants-reply.png, ai-chat-product-context-tenants-flow.mp4). The assistant typically says Tenants in the left menu (may omit the Portfolio group name). Canonical route: /tenants.

AI Assistant — where to open Tenants to find a person and review debt across stays

Walkthrough: ask AI Assistant where to open Tenants for people search and per-person debt, then open Portfolio → Tenants (reply may say left menu without naming Portfolio).

Opening a tenant by URL​

Append the tenant UUID to open the profile sidebar directly, for example /tenants/<tenantId>. If the id does not exist or is outside your account scope, the app shows Tenant not found., clears the bad segment, and returns you to /tenants — see Deep Links — Broken entity deep links.

What You Can Do in the Tenants Module​

The module opens on a list/grid of tenant records with fast filtering and search:

  • Search by tenant name, email, phone, fiscal ID (NIF / VAT), or identification ID — the directory haystack matches any of these fields server-side (accent-insensitive substring match). A query that spans first and last name (for example Tim Trompa) matches the concatenated full name, not only each column separately.
  • Segment by status: All, Active, Inactive, With Debt, No Bookings
  • Sort in table view via column headers (Name, Phone, Total, Balance, Status)
  • Export the current directory slice as Tenants CSV or Bookings CSV (same filters, search, sort, and status segment as the on-screen list)

Directory loading (infinite scroll)​

The tenant directory is server-paged in both grid and table views. The first request loads a batch of rows; as you scroll near the bottom of the page, the app loads the next batch automatically (skeleton placeholders appear while fetching). When every tenant matching your current search, status segment, and sort is loaded, an End of list line appears. Changing any of those controls resets the list and starts from the first batch again — exports always reflect the full filtered result set, not only the rows currently on screen.

If this list needs a refresh — Use Retry on the directory when the list is empty and you expect tenants. Zero rows after a successful load means your filters matched nothing. See Glossary — Directory list refresh.

While the next batch loads, compact skeleton cards (grid) or table skeleton rows (table view) appear at the bottom of the directory:

Tenants — grid directory loading the next page with skeleton placeholder cards at the bottom

Tenants — directory scrolled to the end with the End of list marker (search narrowed to a clean example tenant)

Selecting a tenant opens a detail sidebar with dedicated tabs:

  • Tenant Info — personal details, billing details, bank details, and Category (when tenant categories exist)
  • Bookings — all bookings linked to that tenant
  • Payments — payment plan context from the tenant's bookings
  • Transactions — received payments and allocation history

Core Workflows​

Pair with other Tenants sections

With Debt triage pairs with Finance module and Handling a Late Payment — create profiles via Create New menu — Tenant.

1) Prioritize Collections and Follow-up​

Use the With Debt filter to quickly identify tenants whose net balance is negative (they still owe money across linked bookings). Open each tenant to validate booking context, then coordinate with the Finance module for payment reconciliation.

2) Review Tenant Activity Across Multiple Bookings​

Use a single tenant profile to review active and historical bookings without opening each reservation from the bookings table.

3) Maintain Tenant Master Data​

Open Tenant Info to update personal/contact details, assign a tenant category (portal and field rules), and maintain billing information used by downstream finance workflows. Saving a new Category back-syncs booking.tenantCategoryId on linked reservations immediately. Ledger tabs (Contract Values, Deposits, Income, …) reflect the segment on reload; Overview can lag up to ~10 minutes — see Glossary — Finance tenant category cache refresh.

Use + Create New → Tenant when you need a tenant record before a booking exists (for example a direct enquiry). The modal collects required identity fields and an optional tenant category:

Tenants — Add tenant modal from Create New with sample identity fields (not submitted)

On Tenant Info, click the pencil icon on Personal Information to enter edit mode — category, contact fields, and email-change rules appear inline:

Tenants — Tenant Info edit mode with personal fields and category selector (example tenant Luisa Köster)

See also Create New menu — People.

4) Investigate Payment Status with Context​

Use Payments and Transactions tabs to understand what is scheduled versus what has been paid, then jump into Bookings for contract-level actions when needed.

Permissions and Access​

Tenant visibility and editability depend on role permissions:

  • Accessing the Tenants module (sidebar entry + /tenants route) requires Tenants module permission (tenants.module).
  • Creating or updating tenant records requires tenants.create permission (in addition to tenants.module).
  • The Bookings tab depends on Bookings module permission (bookings.module).
  • The Payments tab depends on Bookings module permission (bookings.module).
  • The Transactions tab depends on Finance module permission (finance.module).

Review and adjust role access in Settings > Users.

Interface overview​

Pair with other Tenants sections

Tenant category filter pairs with Bookings — Tenant categories stays open and Finance — Tenant category filter — bookmark searches with Deep Links — Tenants ?q=.

The Tenants screen combines a toolbar (search, tenant category filter, status filters, sort, view toggle between grid and table, export) with a tenant directory. Status pills (All, Active, Inactive, With Debt, No Bookings) show live counts from the server; pick a segment before you sort or export so the file matches the slice you reviewed.

Tenants — grid directory with status pills (All, Active, Inactive, With Debt, No Bookings) and toolbar

Tenant category filter​

When your account has at least one tenant category configured, the toolbar includes an All categories dropdown (desktop). Pick one or more segments to narrow the directory to tenants assigned that category on Tenant Info, or choose No category for profiles with no segment. The menu stays open after each tick — see All categories stays open. Search, status pills, sort, grid vs table, and Export all respect the filter server-side — downloads reflect the full filtered population, not only rows already loaded by infinite scroll.

Tenants — toolbar tenant category filter with one segment active and narrowed directory

Use Search when you want a tight view of one tenant or a small set of matches — especially helpful in busy directories where the default sort can surface mixed or internal test labels at the top of the list. Paste a fiscal ID or ID number when collections or onboarding paperwork references the tax id instead of the tenant’s display name.

Tenants — grid directory with Search narrowed by fiscal ID (NIF)

All categories stays open while you pick​

Open All categories, then tick a named segment. A chip appears under the toolbar; the menu stays open so you can tick a second segment. You do not need to open All categories again.

Tick a named segment from Settings > Tenant categories (for example Corporate), then No category. Both stay checked in the open list. The directory shows tenants that match any of those choices — the named segment or profiles with no category — not only tenants that have both. Dismiss the menu when the chips look right — same stay-open habit as Bookings — Booking categories. Select all is on Bookings → Tenant categories and Finance → Other filters, not on this All categories menu — tick rows one by one here.

Bookings → Tenant categories is a different control on the reservation list. Its English placeholder is Tenant categories and the empty-case row is No tenant category. That menu also stays open while you add a second segment.

Emails → Communication Rules → Tenant categories is a different audience picker: named segments only, English placeholder Select tenant categories…, and Include only / Exclude modes — it does not list No tenant category.

Finance → Other filters → Tenant → Tenant category is a drawer control (empty-case label No tenant category). Tick boxes there stay visible because the drawer stays open — not the same toolbar dropdown.

Bookmarkable search (?q=)​

The toolbar Search field syncs to the URL query parameter q. Share or bookmark a filtered directory view, for example platform.vivin.app/tenants?q=smith.

  • On load, back, or forward navigation, the input hydrates from ?q= so bookmarked or shared links land on the same filtered list.
  • As you type, the URL updates after a short debounce (~250ms) with replace so history does not stack one entry per keystroke.
  • Clearing the search removes q from the URL.
  • Status pills, sort, and grid vs table stay in component state only — they are not encoded in the URL today.
  • The directory API request debounces separately (~1s) so typing stays responsive while the server catches up.

Tenants — list with toolbar Search pre-filled from /tenants?q= with filtered rows visible after load

Tenants — grid view with search narrowed to one tenant

Tenants — table view with the same search filter

Grid card anatomy (dense directory view)​

In grid view, each tenant card is a self-contained summary — useful for collections and multi-booking follow-up without opening the full profile first.

RegionWhat it shows
Header (clickable)Avatar, name, Active / Inactive pill, email, phone, nationality flag — opens the tenant detail sidebar (/tenants/<id>).
Balance stripRoll-up Balance (net financial position across linked bookings). Shown only when balance ≠ 0 — red when the tenant owes money, teal when credit remains.
Booking groupsReservations grouped by status — Ongoing, Upcoming, Ended, Cancelled, Refunded — with up to two rows per group before collapse. Within each list Vivin keeps the same deterministic booking order.
Per-booking rent / balanceEach preview row shows rent on the right; when a booking has negative financial balance, a red amount appears under rent (same rules as Bookings).
Show all bookings / Show lessExpands the card when a tenant has more bookings than the preview limit.
Booking row clickOpens the booking sidebar in place (contract-level context) without navigating away from the directory.

When a tenant has more bookings in a status group than the preview limit (two rows per group), the card stays collapsed until you click Show all bookings. Show all bookings reveals every row in that card; Show less returns to the preview limit so dense directories stay scannable.

Click any booking row (not the tenant header) to open the booking sidebar while staying on /tenants — useful when you are triaging debt on the card and need contract or payment context without losing your filter.

Tenants — grid card collapsed with Show all bookings under Upcoming / Cancelled previews

Tenants — grid card expanded with Show all bookings revealing additional reservation rows

Walkthrough: on Tenants grid, open a dense card with Show all bookings, expand the full Upcoming / Cancelled lists, then Show less.

Use table view when you need column sort and dense scanning; use grid when debt and booking mix matter at a glance. Cross-module triage: Handling a Late Payment (With Debt + expand), Glossary — Tenants table expand, Deep Links — Tenants.

Table view (expandable booking rows)​

In table view, each tenant occupies one summary row. Sort by Name, Phone, Total, Balance (net roll-up), or Status using the column headers. Wider breakpoints also show Nationality, a compact Bookings breakdown (coloured chips such as on / up / en / ca for ongoing, upcoming, ended, and cancelled counts), and Category.

ActionResult
Click the row (chevron area)Expand or collapse an inline sub-table of that tenant’s linked bookings.
Click the tenant nameOpen the tenant detail sidebar (/tenants/<id>) without leaving the directory.
Click a booking sub-rowOpen the booking sidebar in place (same pattern as grid cards).

When expanded, a header row labels the sub-table columns:

Column (English UI)What it shows
UnitListing internal name for the reservation.
RentContract rent for that booking.
CreatedBooking creation date (when the viewport is wide enough).
StatusBooking status badge (Ongoing, Upcoming, etc.).
PeriodContract / move-in window for the stay.
BalanceCurrent booking balance from the same rules as Bookings — red when the tenant owes money, teal when credit remains, em dash when settled.
SrcSales platform icon (channel source).
CTContract indicator: teal check when signed, grey document when not, grey dash when there is nothing to sign (the tenant's category has Tenant Portal Access or the Contract portal module turned off). Hover Signed on for the timestamp, Contract not signed, or Not applicable. After you upload a signed PDF (or the tenant signs in the portal), this icon updates on the expanded row you already have open — the Tenants directory does not jump to the first page. See Bookings — Contract mark stays on the list (tenants-table-ct-signed-check.png).

Tenants with no linked bookings show an italic No bookings line when you expand the row.

Tenants — table expand for Sagaras Jayasinghe, CT check with Signed on tooltip

How linked bookings are ordered​

Every “bookings for this tenant” list uses the same server-side order — table expand sub-rows, grid card previews (Show all bookings), the sidebar Bookings tab, and the Bookings CSV export sheet:

  1. Check-in date (earliest first)
  2. Check-out date (when check-in matches)
  3. Unit internal name with natural numeric compare (same family as Listings — Unit order — for example Room 2 before Room 10)
  4. Booking id as a stable tiebreak

Corporate or group tenants that share one period across many units therefore see units in a stable, scannable sequence instead of Postgres heap order (which used to reshuffle when balances were rewritten). Sorting is server-side because grid cards only preview a slice of each status group — the client cannot reorder rows the preview already dropped.

Tenants — table expand with linked bookings ordered by check-in then unit (AA-11-5D-R4 → R1 → R7 → Q5)

Tenants — sidebar Bookings tab with the same chronological / unit order

Walkthrough: search a multi-booking tenant, expand the table sub-rows to read check-in then unit order, open the profile sidebar Bookings tab (same order), then close without changing data.

Tenants — table view with one row expanded showing Unit / Rent / Balance booking sub-table

Walkthrough: switch to table view, narrow with Search, expand a tenant row to the booking sub-table, open the tenant name sidebar, then collapse the row.

Export (Tenants CSV / Bookings CSV)​

Use Export on the toolbar when you need a spreadsheet of the same slice you are reviewing (status pills, Search, sort, and grid vs table view all apply server-side).

Open Export, then choose:

OptionFile
Tenants CSVOne row per tenant in the current result set (directory fields).
Bookings CSVBooking rows linked to tenants in that same filtered directory view — each tenant’s bookings follow the same deterministic order as the table expand and sidebar. The file starts with Booking ID (Vivin booking UUID) so each stay can be reconciled without matching on tenant name and dates alone.

Downloads use dated filenames from the API. If the filtered list is empty, the export action does not produce a file.

When the export API returns an error (for example HTTP 400/500), Vivin shows a toast (Export failed.) instead of leaving the menu closed with no file — narrow filters or retry after connectivity improves. See Glossary — Export and download issues. The Bookings list uses an inline alert under the toolbar for the same class of failure.

Tenants — Export menu (Tenants CSV and Bookings CSV) with search narrowed to a single tenant

Tenants — Bookings CSV export column slice highlighting Booking ID as the first column before Tenant Email and Tenant Name

Walkthrough: Tenants → Export → Bookings CSV — Booking ID is the first column before Tenant Email / Tenant Name.
Walkthrough: status pills (All, With Debt, Active), narrow with Search, switch grid / table, then open a tenant sidebar on a clean example row.

Tenant detail sidebar​

Click a tenant card header, a table row name, or use Edit flows from the directory to open the detail sidebar on the right. (In table view, clicking the row body expands bookings inline — use the name link for the profile sidebar.) The URL updates to /tenants/<tenant-id> so you can bookmark or share a profile (subject to the same Tenants module permission). The sidebar header shows the tenant name and status; close it with the X control or by navigating back to /tenants.

Portal language​

Pair with other Tenants sections

Portal language pairs with Tenant Portal — Language switcher (what the tenant taps), Portal settings — Default language (account fallback), and Interface language (your workspace locale). Distinct from Tenant Info pencils (this control saves on change).

In the tenant sidebar header, Portal language is a compact select (not behind a Tenant Info pencil). Options: Account default (follow Portal settings — Default language), English, Português, Español, and Italiano. Picking a language saves immediately (Portal language updated). Account default writes “no personal override” — that is not the same as picking English. A tenant who then uses the portal language switcher keeps their own pick on every stay.

Tenants — sidebar header Portal language set to Account default

Tenants — Portal language menu (Account default, English, Português, Español, Italiano)

Tenants — detail sidebar open with Portal language in the header

Walkthrough: open a tenant sidebar, read Portal language (Account default), open the menu, then leave without changing the value.
TabWhat you see
Tenant InfoPersonal Information, Billing Information, and Bank Details in one scrollable view (grid layout aligned with the booking sidebar). Each section has its own pencil edit control when your role includes tenants.create. Personal Information includes First Name and Last Name — Tenant Portal — First name and last name — Phone — Tenant Portal — Phone — Nationality — Tenant Portal — Nationality — ID Number, ID Document Type, ID Document Country, and ID Expiry Date — Tenant Portal — ID document details — plus Fiscal ID and Home address — Tenant Portal — Fiscal number and home address. Lease Purpose is not on Tenant Info — operators set it on the booking Contract Info; tenants pick it on portal Your Details — Tenant Portal — Lease Purpose. Billing Information includes Billing address, Postal Code, City, and Country — Tenant Portal — Billing address — plus Use company details for billing (Yes/No in view; toggle in edit) — Tenant Portal — Use company billing. Bank Details lists IBAN, SWIFT/BIC, bank name, branch, interbank code, and bank address — there is no European bank account toggle here; that switch lives only on the Tenant Portal. When portal bank or billing editing is locked, operators still change these values here — tenants see amber notices instead of editable cards. Tenants confirm their own portal edits with Save changes success (Details updated successfully!); that notice does not appear on this sidebar.
BookingsAll reservations linked to this tenant (requires Bookings module), in the same deterministic order as table expand and grid previews.
Payment PlanConsolidated chronological payment-plan timeline across every linked booking, with a Booking attribution column. Requires Bookings module.
Contract ValuesConsolidated contract-value / receivables table across those bookings, also with a Booking column. Requires Finance / Bookings as applicable.
TransactionsReceived payments and allocation history merged across bookings, with Booking attribution. Requires Finance module.

Tenants — detail sidebar on Tenant Info with personal and billing sections

Tenants — detail sidebar Bookings tab listing linked reservations

Tenants — sidebar Bookings tab with chronological then unit order

Consolidated finance tabs (Payment Plan, Contract Values, Transactions)​

When a tenant has more than one booking, the three finance tabs mirror the booking sidebar surfaces but merge every stay into one view. Each row keeps a Booking label that operators already recognise elsewhere in the product:

  1. Unit internal name alone when it is unique among this tenant's stays (for example AA-11-5D-R4)
  2. Unit + stay dates when the same unit appears more than once (same pattern as the booking sidebar title)
  3. Unit + short id only when unit and dates collide — a last-resort fallback, never the default

A header All bookings filter narrows the consolidated tables to one stay (options use the same labels); pick a specific booking before + Charge, + Transaction, or Apply Discount (those actions always target one reservation).

Payment Plan shows the shared due-date timeline (status pills, rent/fee columns, totals) with the Booking column on every group:

Tenants — detail sidebar Payment Plan tab with unit Booking labels and All bookings filter

Contract Values reuses the booking Contract Values table (status cards, line filters, allocations) with the same Booking attribution. Pending utility allocations from every linked stay appear on All and Other here too — the All bookings filter narrows both the charge lines and those Pending rows. Approve or reject them on this tab (you need Approve payments); bulk work still lives on Utilities → Allocations.

Tenants — detail sidebar Contract Values tab with unit Booking labels across linked stays

Transactions lists received payments and allocation history pulled from those bookings (filters for in/out payment types when transactions exist), again with a Booking column. Manual receipts may still show as pending until someone with Approve payments confirms them on Finance → Transactions or the booking Transactions tab — the tenant-level roll-up can look settled while Pending rows still exist on the ledger (the Overview Manual Payments KPI includes approved manual receipts too). While a row is still pending, the pencil Edit amount corrects a typed-wrong € (Bookings — Edit payment amount). Reject payment, bulk Reject selected, and Revert payment modals warn about credit notes when Finance may already have invoiced the charge — see Payment Allocation — Correcting mistaken receipts. See Finance — Pending manual payments.

Tenants — detail sidebar Transactions tab with unit Booking labels and All bookings filter

Walkthrough: open a multi-booking tenant sidebar, then review consolidated Payment Plan, Contract Values, and Transactions with unit Booking labels and the All bookings filter.

From Bookings or Transactions, use in-sidebar links to jump into the Bookings module when you need contract-level actions (including per-row Approve payment when a receipt is still pending).

Tenants guide subsection index​

Pair with other Tenants module guide sections

This index pairs Tenants directory, profile, and segment sections with Related subsections — use it when With Debt rows disagree with Finance ledgers or Bookings reservation context.

SubsectionWhen to open itPair with
Access PathSidebar route and deep linksDeep Links — Tenants, Deep Links — Broken entity deep links
What You Can Do in the Tenants ModuleSearch, status pills, infinite scrollGlossary — Directory list refresh, Glossary — Directory search ranking
Core WorkflowsCollections, multi-booking review, master dataHandling a Late Payment, Processing a New Booking
Permissions and Accesstenants.module gateSettings > Users and roles
Interface overview — Tenant category filterAll categories toolbar segmentAll categories stays open, Bookings — Tenant categories, Finance — Tenant category filter, Settings > Tenant categories
All categories stays open while you pickAll categories stays open while you add another segment or No categoryTenant category filter, FAQ — Does picking a second tenant category close the Tenants menu?, Bookings — Select all on category filters, Emails — Tenant categories stays open, Bookings — Tenant categories stays open
Interface overview — Bookmarkable search (?q=)Shareable filtered directory URLsDeep Links — Tenants
Interface overview — Grid card anatomyDense directory without opening profileBookings module, Handling a Late Payment — Step 1
Interface overview — Table viewInline booking sub-rowsGlossary — Tenants table expand, Bookings — Contract mark stays on the list (tenants-table-ct-signed-check.png)
Interface overview — ExportCSV downloads for current sliceBookings — Exporting the list, Glossary — Export and download issues
Tenant detail sidebarProfile tabs for one tenantConsolidated finance tabs, Bookings — Pending utility allocations, Finance — Transactions tab, Payment Allocation
Deeper workflow readsStep-by-step procedures in this moduleCommon Workflows hub subsection index, Handling a Late Payment
Lockout catch-up after password recoverySign-in restored; module backlog accumulatedCommon Workflows — Lockout catch-up, Getting Started — Lockout catch-up, Resetting a Management User Password — Step 3
Pending manual receipt approvalRecorded bank transfers still pending until Approve paymentsCommon Workflows — Pending manual receipt approval, Finance — Pending manual payments, FAQ — Manual receipt still pending
Reject/revert mistaken receiptsDuplicate or wrong-booking receipts after ApproveCommon Workflows — Reject/revert mistaken receipts, Payment Allocation — Correcting mistaken receipts, Glossary — Credit note (payment reject/revert)
Cancel Booking vs Delete BookingDelete soft-archives reservation — not tenant profile removalCommon Workflows — Cancel Booking vs Delete Booking, Bookings — Delete Booking (soft archive), FAQ — Cancel Booking vs Delete Booking (bookings-cancel-booking-modal-refund-types.png, finance-transactions-type-summary-cards.png, workflows-cancel-booking-refund-modal-flow.mp4)
Wrong tenant on a bookingBooking linked to wrong profile — Change tenant not profile overwriteCommon Workflows — Wrong tenant on a booking, Bookings — Change tenant, FAQ — Wrong tenant on a booking (bookings-detail-change-tenant-control.png, bookings-detail-change-tenant-flow.mp4)
Notification row-click navigation/notifications row-click with tenantId opens profile sidebarCommon Workflows — Notification row-click navigation, Notifications module — Notification row-click navigation, FAQ — Notification row-click navigation (tenants-module-detail-sidebar-tenant-info.png, notifications-row-navigation-flow.mp4)
Payment alert to receivables triageWith Debt cross-check after payment overdue row-clickCommon Workflows — Payment alert to receivables triage, Handling a Late Payment — Step 1, Finance — Payment alert to receivables triage (tenants-module-status-pills-default.png, notifications-row-navigate-to-booking-detail.png)
Confirmation alert triageTenant Info / Category on confirmation-week alert clustersCommon Workflows — Confirmation alert triage, Notification triage — Confirmation alert triage, Processing a New Booking — Step 6 (tenants-module-detail-sidebar-tenant-info.png, notifications-row-navigation-flow.mp4)
Portfolio segmentation by tenant categoryReview one tenant segment across modulesCommon Workflows — Portfolio segmentation, Settings > Tenant categories, Finance — Tenant category filter, Tenants — Tenant category filter
Finance debt receivables triageWith Debt segmentation may rank differently than portfolio Top debtorsCommon Workflows — Finance debt receivables triage, Finance — Finance debt receivables triage, FAQ — Finance debt receivables triage hub, Core Workflows — Prioritize collections, Payment alert to receivables triage (finance-overview-debt-aging-expanded-bucket.png, finance-overview-debt-aging-walkthrough-flow.mp4)
Finance Income status drill-downWith Debt cross-checks single-tenant balance vs Income → In debt month modalCommon Workflows — Finance Income status drill-down, Finance — Income status drill-down, FAQ — Finance Income status drill-down hub, Core Workflows — Prioritize collections, Finance debt receivables triage (finance-overview-income-status-in-debt-modal.png, finance-overview-income-drill-down-flow.mp4)
Cash flow forecast drill-downWith Debt shows single-tenant balance — Cash flow forecast lists portfolio-wide collectionsCommon Workflows — Cash flow forecast drill-down, Finance Income status drill-down, Finance — Income chart and cash flow forecast, FAQ — Cash flow forecast drill-down hub, Core Workflows — Prioritize collections, Finance debt receivables triage (finance-overview-cash-flow-all-payments-modal.png, finance-overview-cash-flow-day-view.png, finance-overview-cash-flow-drill-down-flow.mp4)
Tenants section cross-referencePer-section pairing matrixModule cross-reference, Bookings guide subsection index

Tenants section cross-reference​

Use the sections above for this module. Related pages are linked from Related below when present, or from Modules.

Pair with other Tenants module guide sections

Related below links this module to settings, concepts, workflows, and escalation paths.

Documentation map & escalation​

Upstream & downstream workflows​

Deeper workflow reads​

See Upstream & downstream workflows above for the same guides.

Settings that shape Tenants​

Deeper concept reads​

Operator modules (pairing surfaces)​

Pair with other Tenants module guide sections

Bookmark routes pair with Management Frontend Deep Links and Create New menu.

Operator habit hubs​

Day-to-day operator habits (lockout catch-up, pending receipts, payment triage, handoffs, and related playbooks) live on the Common Workflows habit hub.

Deep-link anchors for habit hubs

Lockout catch-up after password recovery​

Pending manual receipt approval​

Reject/revert mistaken receipts​

Check-out ledger cleanup before refund​

Utility overage collections​

Cancellation collections before void​

Check-out collections before refund​

Handling a Late Payment collections​

Check-out vs cancellation​

Deposit missing on Finance Deposits​

Cancel Booking vs Delete Booking​

Wrong tenant on a booking​

Notification row-click navigation​

Payment alert to receivables triage​

Finance debt receivables triage​

Finance Income status drill-down​

Cash flow forecast drill-down​

Confirmation alert triage​

New inventory to first booking handoff​

Property setup to first arrival handoff​

Confirmation to check-in handoff​

Check-in to check-out handoff​

Check-out final utilities handoff​

Same-day turnover coordination​

WhatsApp per-booking messaging​

Bot reasoning (audit)​

ChatBot settings​

Rent reduction after invoicing​

Month-end invoicing (fixed date)​

Bulk Hostkit invoicing​

Occupancy KPI to block hygiene handoff​

Partly collected security deposit​

Portfolio segmentation by tenant category​

Directory list refresh​

When a list needs a refresh instead of showing rows, use Retry or reload the page. Zero rows after a successful load means your filters matched nothing — widen filters or clear search.

See FAQ — Directory list refresh and Glossary — Directory list refresh.

Key glossary terms​

API & companion guides​

Module documentation hubs​

  • Tenants module — Tenant directory, profile sidebars, With Debt segmentation, and table expand for linked bookings (this page)
  • Utilities module — Bills Included ceiling model, Connections, AI bill upload, and tenant overage charges on payment plans (hub)
  • Operations module — Maintenance tickets, cash flows, check-in/out coordination, Draft ticket queues, and linked cash flows (hub)
  • Dashboard module — Post-login Today, Total debt, Vacant Units, and forecast KPI snapshot with bell notification triage (hub)
  • Analytics module — Month-range portfolio KPI charts (Overview, Revenue, Occupancy, ADR, RevPAR, Maintenance) with rankings and heatmaps (hub)
  • Listings module — Property wizard, Channels tab, Archived inventory, and unit management (hub)
  • Properties workspace — Legacy /properties URL redirects into Listings (hub)
  • Booking engine details — Rich marketplace payload editor via the Full integration pill (hub)
  • Finance module — Portfolio ledgers (Overview, Income, Contract Values, Transactions, Payouts, Deposits) with payment approval and deposit settlement (hub)
  • Sales module — Portfolio availability, monthly rent editing, and channel manager connections (hub)
  • Inbox module — Portfolio-wide WhatsApp workspace with Dashboard bell Inbox sub-tab deep links (hub)
  • Notifications module — Full /notifications history with search, filters, and row-click navigation (hub)
  • AI Chat module — AI Assistant using Landlord MCP tools for portfolio Q&A (hub)
  • Audit module — Portfolio-wide Manual Blocks and Discounts contract-value review (hub)
  • Account Settings — Workspace-wide financial policies, templates, integrations, and operational defaults (hub)
  • API Reference hub — Partner HTTP contracts, Swagger onboarding, and partial vs full feeds (hub)