Skip to main content

Owners

First-time workspace setup

Complete Getting Started — Recommended Setup Sequence step 4 (this tab — landlord registry before property wizard) after step 3 Users and before step 5 Payments — full tab map: Recommended setup order. Finish steps 13–15 in Listings, Bookings, and Tenants, then Onboarding a New Property — Step 7. Guided steps 4–12: Onboarding a New Property. Lockout catch-up: Getting Started. Workflow pairing after go-live: Account Settings — Setup sequence after go-live.

Direct access

Open Account Settings > Team > Owners at platform.vivin.app/settings/owners. It sits next to Users and roles in the settings sidebar. See Deep Links for neighbouring routes.

Pair with other Account Settings tabs

Pair owner legal records with Users (who can edit payouts and properties), Contract (owner variables in generated PDFs), and General Information (operator company identity — distinct from landlord IBANs here). Month-end owner payout reconciliation pairs with Portfolio KPI review — Step 7 and optional AI usage API (landlord_chat) when MCP catch-up followed lockout. Section-to-doc pairing: Owners section cross-reference. Hub tab matrix: Account Settings — Tab cross-reference.

The Owners tab is where you register and manage property owners. Owners are the individuals or companies that own the properties you manage. Adding owners here allows you to:

  • Associate properties with their correct owner
  • Generate owner statements and payout records
  • Display owner details on contracts and legal documents

Use this page to add, edit, and manage owners — including required fields (Legal Name, Email, Fiscal ID, IBAN, etc.) and how owner data flows into contracts and payouts.

How to open Owners in the app

  1. Sign in to the management frontend and open Account Settings (gear / company entry in the user area, or go straight to /settings).
  2. In the Account Settings left sidebar, under Team, choose Owners (same shell as Users and roles).
  3. Use + Add Owner for a new record, or open an existing row to edit banking and identity details before they are picked on properties or payout runs.

Bookmark: platform.vivin.app/settings/owners — see Deep Links for neighbouring settings routes.

Screenshots

Account Settings — Team — Owners — settings shell with the Owners list, search, and Add Owner (full desktop layout):

Account Settings — Team — Owners tab with owner cards, search, and add control in the settings shell

Adding or editing an owner

Pair with other Owners sections

Create payout-ready owner records before Listings — Creating a New Property — the property wizard Owner dropdown only lists landlords registered here. Full pairing matrix: Owners section cross-reference.

  1. On the Owners tab (see How to open Owners in the app above), click + Add Owner to register someone new, or use the pencil on an existing owner card to edit inline.
  2. Complete or update the form (legal identity, contact, and banking fields as shown in your workspace)—pay special attention to IBAN and fiscal identifiers before the next payout cycle.
  3. Save from the card footer (inline edit) or the modal footer (Add Owner). Updated values flow into new contracts, statements, and payout destinations; review open bookings if you change identifiers mid-season.

Add Owner opens a centered dialog with the fields you need before a property can reference that payee (display name, legal name, email, phone, fiscal ID, IBAN, fiscal address, and ID document type). Name, Email, and Fiscal ID are required on create:

Account Settings — Add Owner dialog with identity, contact, and banking fields

Existing owners are edited inline on their card (pencil control) rather than in this modal — the card expands with the same field groups and Cancel / Save actions in the footer:

Account Settings — owner card in inline edit mode with editable fields and Cancel / Save

Search and delete

  • Search — the header search box matches display name and email (case-insensitive). The owner count in the title still reflects the full list; the grid below narrows to matching cards.
  • Delete — the trash icon on a card opens a confirmation dialog naming that owner. Deletion is permanent — remove an owner only when no properties should reference them going forward.

Account Settings — Owners search narrowed to one matching card

Account Settings — delete owner confirmation dialog

Walkthrough: narrow the owner list with Search, open inline edit with the pencil control, Cancel without saving, then open Add Owner and close the dialog (demo does not create or delete records).

What you maintain here

Pair with other Owners sections

Owner IBAN and fiscal identifiers flow into Finance — Payouts and contract variables on Contract templates — reconcile open Finance — Contract Values before mid-season banking changes. Full pairing matrix: Owners section cross-reference.

  • Create — Use + Add Owner to register a new legal entity or person before they appear on properties or payout reports.
  • Edit — Update banking, fiscal, or contact details when they change in the real world; outdated IBANs or fiscal IDs will flow into the wrong statements until corrected.
  • Associate — Owners are picked from this list when you assign an Owner on a property in Listings; the link drives Payouts and owner-facing totals elsewhere in Finance.

Typical fields you should expect to complete for a usable payout-ready record (wording in the app may vary slightly by locale):

AreaWhy it matters
Legal identityName and fiscal identifiers used on contracts and tax-related exports
ContactEmail and phone for operational correspondence
Banking (IBAN)Destination for owner payouts from your Vivin-managed rent collection workflow
ID document typeThe kind of identity document the owner signs with (Passport, ID Card…). Optional; fills {OwnerIdDocumentType} on contract templates

Those fields are reused wherever the product needs a stable legal payee for a property: the Owner selector in Listings (property setup), Payouts rows in Finance, and contract or export surfaces that print owner identity. Keeping Legal Name and Fiscal ID aligned with your real-world entities avoids mismatches on statements and tax artefacts.

Business Rule

An owner record must exist before you can create a property assigned to that owner. If an owner is not in this list, the Owner dropdown in the property creation wizard will not show them.

Owners section cross-reference

Use this table when one Owners topic naturally leads into another Account Settings tab, operator module, workflow, or concept — each row links to the docs you should read before or after saving landlord records.

| Owners topic / section | Pair with these docs | | --------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | Adding or editing an owner | Onboarding a New Property, Create New — Owner | | What you maintain here | Listings module, Finance — Payouts | | Search and delete | Users and roles, Portfolio KPI review | | Lockout catch-up after password recovery | Resetting a Management User Password, Getting Started — Lockout catch-up, Common Workflows — Lockout catch-up | | Pending manual receipt approval | Invoicing & Payments — Out Payments, Users and roles — Role permissions (Approve payments), Finance — Pending manual payments | | Reject/revert mistaken receipts | Payment Allocation — Correcting mistaken receipts, Finance — Payouts, Finance — Row actions on in-payment rows | | Notification row-click navigation | /notifications row-click before owner payout fixes | Account Settings — Notification row-click navigation, Common Workflows — Notification row-click navigation, Notifications module — Notification row-click navigation | | Payment alert to receivables triage | payment overdue before Owners payout recipient setup | Account Settings — Payment alert to receivables triage, Common Workflows — Payment alert to receivables triage, Handling a Late Payment — Step 1 | | Confirmation alert triage | Upcoming alerts on owner-payout bookings | Account Settings — Confirmation alert triage, Common Workflows — Confirmation alert triage, Processing a New Booking — Step 5b | | Finance debt receivables triage | Portfolio Top debtors / Debt Aging after settings on this tab | Account Settings — Finance debt receivables triage, Common Workflows — Finance debt receivables triage, Finance module — Finance debt receivables triage | | Finance Income status drill-down | Income → In debt vs Debt Aging after settings on this tab | Account Settings — Finance Income status drill-down, Common Workflows — Finance Income status drill-down, FAQ — Finance Income status drill-down hub | | Cash flow forecast drill-down | Cash flow forecast month bars vs Income segments | Account Settings — Cash flow forecast drill-down, Common Workflows — Cash flow forecast drill-down, FAQ — Cash flow forecast drill-down hub | | Portfolio segmentation by tenant category | Tenant categories, Finance — Other filters, Common Workflows — Portfolio segmentation |


Pair with other Owners guide sections

Related below links this Account Settings tab to modules, workflows, concepts, and escalation paths. Pair Documentation map & escalation with Account Settings hub — Documentation map & escalation; pair Upstream & downstream workflows with Account Settings — Tab cross-reference. Topic-to-section pairing in sections above: Owners section cross-reference. Full hub matrix: Account Settings — Section cross-reference.

Documentation map & escalation

Upstream & downstream workflows

Pair with other Owners guide sections

Workflow bullets pair with Common Workflows — Workflow cross-reference for inter-guide step pairing. Full pairing matrix: Owners section cross-reference · Account Settings — Section cross-reference.

Deeper workflow reads

Pair with other Owners guide sections

Workflow reads pair with Common Workflows hub subsection index and Workflow cross-reference. Each workflow sub-guide reciprocates with [Deeper workflow reads](./owners.md#deeper-workflow-reads) anchors on Account Settings bullets — hub parity: Account Settings hub — Deeper workflow reads. Full pairing matrix: Owners section cross-reference · Account Settings — Section cross-reference.

Pair with other Owners guide sections

Operator modules

Pair with other Owners guide sections

Deeper concept reads

Pair with other Owners guide sections

Companion API guides

Pair with other Owners guide sections

Module documentation hubs

Pair with other Owners guide sections
  • Dashboard — Post-login KPI snapshot
  • Analytics — Month-range portfolio KPI charts
  • Bookings — Operator UI for reservations on owner-linked properties
  • Sales — Portfolio availability and channel connections
  • Utilities — Bills Included ceiling model
  • Inbox — Portfolio-wide WhatsApp workspace
  • Notifications — Full /notifications history
  • AI Chat — Vivin-internal AI Assistant
  • Booking engine details — Marketplace payload editor

Lockout catch-up after password recovery

Pair with other Owners guide sections

Operational backlog after sign-in recovery pairs with Resetting a Management User Password — Step 3 before you resume owner IBAN edits on this tab. Hub parity: Common Workflows — Lockout catch-up after password recovery. Full pairing matrix: Owners section cross-reference · Account Settings — Section cross-reference.

Pending manual receipt approval

Pair with other Owners guide sections

Receipt approval pairs with Invoicing & Payments — Out Payments owner payout batches and Users and roles (Approve payments permission). Hub parity: Common Workflows — Pending manual receipt approval. Full pairing matrix: Owners section cross-reference · Account Settings — Section cross-reference.

Reject/revert mistaken receipts

Pair with other Owners guide sections

Receipt cleanup pairs with Finance — Payouts owner reconciliation and What you maintain here banking identity. Hub parity: Common Workflows — Reject/revert mistaken receipts. Full pairing matrix: Owners section cross-reference · Account Settings — Section cross-reference.

Portfolio segmentation by tenant category

Notification row-click navigation

Pair with other Owners guide sections

Owner IBAN gaps surface on Finance → Payouts — finish /notifications row-click triage on the booking before blaming owner registry rows for payout warnings. Hub parity: Account Settings — Notification row-click navigation. Full pairing matrix: Owners section cross-reference · Account Settings — Section cross-reference.

Payment alert to receivables triage

Pair with other Owners guide sections

Missing owner banking does not create payment overdue alerts — row-click tenant debt alerts first, then return to owner IBAN fixes for Owners payout mode. Hub parity: Account Settings — Payment alert to receivables triage. Full pairing matrix: Owners section cross-reference · Account Settings — Section cross-reference.

Confirmation alert triage

Pair with other Owners guide sections

Upcoming confirmation alerts on owner-mode payouts still need receipt approval on the booking — owner records do not auto-approve Payment received rows. Hub parity: Account Settings — Confirmation alert triage. Full pairing matrix: Owners section cross-reference · Account Settings — Section cross-reference.

Finance debt receivables triage

Pair with other Owners guide sections

Owner IBAN records enable Out Payments batches — clear tenant Top debtors before owner payout sign-off on Finance → Payouts. Hub parity: Account Settings — Finance debt receivables triage. Full pairing matrix: Owners section cross-reference · Account Settings — Section cross-reference.

Handling a Late Payment collections

Pair with other Owners guide sections

Owner IBAN records enable Out Payments batches — clear tenant Top debtors before owner payout sign-off on Finance → Payouts Hub parity: Account Settings — Handling a Late Payment collections. Full pairing matrix: Owners section cross-reference · Account Settings — Section cross-reference.

Finance Income status drill-down

Pair with other Owners guide sections

Owner registry does not list tenant Income → In debt lines — open Finance → Overview for segment drill-down during owner statement reconciliation. Hub parity: Account Settings — Finance Income status drill-down. Full pairing matrix: Owners section cross-reference · Account Settings — Section cross-reference.

Cash flow forecast drill-down

Pair with other Owners guide sections

Payout type → Owners on Invoicing & Payments groups finalized vIBAN collections — pair with Cash flow forecast month bars before batch approval. Hub parity: Account Settings — Cash flow forecast drill-down. Full pairing matrix: Owners section cross-reference · Account Settings — Section cross-reference.

Key glossary terms

Pair with other Owners guide sections