Skip to main content

Account Settings

The Account Settings module is the central hub for configuring your entire Vivin workspace. All platform-wide rules — financial policies, user access, communication templates, integrations, and operational defaults — are defined here.

Important

Changes made in Account Settings typically affect new records going forward. Existing bookings, contracts, and payment schedules are not retroactively altered when you update settings.

Finding your way in Account Settings

Skim Account and Team for identity and access, then Billing and Property for financial policies and System for integrations and communications that shape Finance and booking payment plans. Hub subsection map: Account Settings hub subsection index (settings sections + Related subsections). First-time administrators should complete Getting Started — Recommended Setup Sequence steps 1–12 on the tabs below before daily operations. Tab pairing matrix: Tab cross-reference. Each Account Settings sub-guide opens with a First-time workspace setup tip tailored to that tab's setup step and a Finding your way in this guide tip with section anchors. Non-linear operator habits (Lockout catch-up, Notification row-click navigation, Payment alert to receivables triage, Finance debt receivables triage, Same-day turnover coordination, Check-out final utilities handoff, Check-out collections before refund, Check-out ledger cleanup before refund, Cancellation collections before void, Utility overage collections, Property setup to first arrival handoff, New inventory to first booking handoff, Confirmation to check-in handoff, Check-in to check-out handoff, Occupancy KPI to block hygiene handoff, Confirmation alert triage, Pending manual receipt approval, Reject/revert mistaken receipts, Portfolio segmentation by tenant category) have matching Related subsections on every Account Settings sub-guide. Full pairing matrix: Account Settings — Section cross-reference.

First-time workspace setup

First-time administrators should complete Getting Started — Recommended Setup Sequence steps 1–12 on the Account Settings tabs below, then finish setup steps 13–15 in Listings, Bookings, and Tenants before daily operations. Guided walkthrough of settings steps 4–12: Onboarding a New Property. After modules go live, run Onboarding a New Property — Step 7. If sign-in was restored mid-setup, see Getting Started — Lockout catch-up after password recovery. Step-to-tab mapping: Recommended setup order. Tab pairing matrix: Tab cross-reference. Workflow pairing after go-live: Setup sequence after go-live (hub parity: Introduction — Setup sequence after go-live, Modules — Setup sequence after go-live, Common Workflows — Setup sequence after go-live, Concepts — Setup sequence after go-live, Glossary — Setup sequence after go-live, FAQ — Setup sequence after go-live, Support — Setup sequence after go-live, API Reference — Setup sequence after go-live). Each Account Settings sub-guide opens with a First-time workspace setup tip tailored to that tab's setup step and a Finding your way in this guide tip with section anchors. Full pairing matrix: Account Settings — Section cross-reference.

Load and save failures — Directory-style modules show explicit Failed to load … cards with Retry (see Glossary — Directory list load failures). Account Settings tabs use a mix of toasts and inline banners — for example Integrations Other providers shows an error toast when the connections API fails. Emails, Services, Invoicing, Tenant categories, and My Profile are documented under Glossary — Settings and profile load failures.

The module is organised into sections of tabs in the left sidebar. The exact tabs you can open depend on your role and permissions (some tabs are hidden or read-only if your role does not include the underlying setting).

The screenshot below shows General Information selected; other tabs use the same shell and header pattern:

Account Settings — General Information tab with company details card and sectioned sidebar navigation

Pair with other Account Settings hub sections

The sidebar sections below (Account, Team, Billing, Property, System) mirror how operators configure a workspace — pair Recommended setup order with Getting Started — Recommended Setup Sequence and Tab cross-reference when one tab depends on another. Full pairing matrix: Account Settings — Section cross-reference.

Account

Team

  • Users — Team members and role-based permissions
  • Owners — Property owners whose assets you manage

The Team section groups member access and owner records under the same Account Settings shell:

Account Settings — Team section with Users tab, team member cards, and Owners in the sidebar

Pair with other Account Settings hub sections

Identity and access tabs above pair with Billing (payment deadlines and invoicing exports) and Property (listing categories and tenant segments) before go-live. Role-gated tabs: Users and roles. Full pairing matrix: Tab cross-reference.

Billing

Pair with other Account Settings hub sections

Financial policy tabs here pair with Integrations (Hostkit / Invoice-xpress) and Emails (payment reminders) before operators reconcile in Finance. Deposit and penalty rules: Invoicing & Payments. Full pairing matrix: Tab cross-reference.

Property

  • Utilities — Utility types enabled for tenant overage billing
  • Categories — Listing tags and types, bookings, tickets, suppliers, cash flows, extra charges, and lease purpose
  • Tenant categories — Tenant segments with portal access, field visibility, and integration defaults (/settings/tenantCategories)
  • Services — Tenant services catalogue (cleaning, gym, parking, etc.)
Pair with other Account Settings hub sections

Property catalog tabs here pair with Listings (Bills Included ceilings, category tags) and Tenant categories (portal segments and integration defaults). Extra charges: Categories. Full pairing matrix: Tab cross-reference.

System

  • Integrations — External platform and service connections
  • Integration capabilities — Read-only field and capability matrix at /settings/integrationFieldCapability (requires integration-related settings permission). See Deep Links.
  • ChatBotTenant-facing assistant: persona text and IF/THEN-style rules for WhatsApp and email at /settings/chatbot. Tab visibility follows the Chatbot permission in Users and roles. Channel behaviour and escalation: Automation & AI. Distinct from the operator AI Chat under Tools (/ai-chat).
  • AI / MCP — Landlord MCP connection URL, API keys, connector OAuth scope (Claude.ai, ChatGPT), account and per-user tool permissions, permission audit trail, and assistant activity at /settings/mcp. Rollout is currently limited to Vivin internal emails (same allowlist as /ai-chat); managers need account_settings.mcp to edit. HTTP contract: MCP OAuth. Concept guide: Landlord MCP.
  • Emails — Automated tenant email customization, communication rules, schedule modal, and Send now confirmation (includes short MP4 walkthroughs)
Pair with other Account Settings hub sections

System tabs here pair with API Reference (partner HTTP contracts), AI usage API (operator JWT ledger for landlord_chat and utility_bill_extraction — distinct from tenant billing), Inbox (portfolio WhatsApp triage), and operator AI Chat (distinct from tenant Chatbot). Field coverage matrix: Integration field capability. Full pairing matrix: Tab cross-reference.

Operator AI Assistant (not in Account Settings)

Signed-in Vivin internal operators use Tools → AI Assistant at /ai-chat for portfolio questions in natural language. That experience is documented under AI Chat; it is separate from Chatbot settings above. Administrators configure Landlord MCP keys and tool scope on AI / MCP (/settings/mcp).

Support (Vivin support tickets)

If your role includes Support access (support.module in Users and roles), you can open Support from the Account Settings shell (lifebuoy entry) to view and manage Vivin support tickets. Full-page routes: /settings/support and /settings/support/:ticketId for a specific ticket. See Using in-app support.

Support-only Account Settings (browse layout)

Some roles are granted Support without any editable Account Settings tabs (for example General Information, Users, or Preferences). When you open /settings in that situation, the product shows a browse-only shell instead of a permission error:

  • Page subtitleUse Support below to reach the Vivin team.
  • Settings tabs — Every standard tab appears in the sidebar but is disabled (greyed out, not clickable). Deep links such as /settings/users redirect back to /settings so you cannot open tabs your role cannot edit.
  • Support — An active Support control at the bottom of the sidebar opens the same Help & Support drawer used elsewhere in the app.
  • Main panel — A short note: Other account settings are not available for your role.

Operators with Support still use the floating Help & Support button on desktop (when applicable) and /settings/support for the full inbox; the browse layout is only the entry when Account Settings itself would otherwise be empty.

Account Settings — support-only browse layout with disabled settings tabs and active Support entry

Screenshot freshness

Support-only browse shell capture refreshed 2026-06-22 03:25 UTC (VIVIN_DOCS_BASE_URL=http://localhost:5173 VIVIN_DOCS_RECORD_API=$VITE_API_BASE_URL npx tsx tools/capture-settings-support-only-browse-shell-screenshot.ts — ACL mock: support.module only).

Your personal profile is managed separately via My Profile at platform.vivin.app/profile, outside the Account Settings tab list.

Personal interface language is changed from Account Settings → Personal Settings (platform.vivin.app/settings/personal), with an extra compact language control in the mobile navigation drawer. It is not on My Profile (/profile) and not under Preferences. See Interface Language.

Direct access

Account Settings routes: platform.vivin.app/settings, plus tab paths such as /settings/users, /settings/integrations, /settings/preferences. See Deep Links for the full route reference.

Pair with other Account Settings hub sections

Support-only operators use the browse layout above without editable tabs — pair with Using in-app support and Get Help & Support. Personal profile routes: My Profile and Personal Settings. Full pairing matrix: Account Settings — Section cross-reference.

Tab cross-reference

Use this table when one Account Settings tab depends on another — each row links to the guide for that tab. Each sub-guide also opens with a First-time workspace setup tip for that tab's step in Recommended setup order. Individual tabs with longer pairing matrices: General Information, Subscription, Personal Settings, Users, Owners, Contract, Categories, Tenant categories, Integrations, Integration field capabilities, Payments, Invoicing & Utilities, Services, ChatBot, AI / MCP, Emails, Preferences, My Profile.

TabPair with these tabs before go-live
General InformationPreferences (check-in/out defaults), Subscription (platform billing), Handling a Late Payment — Step 1, Notifications — Payment overdue alerts
UsersOwners (landlord registry), Personal Settings (per-user locale), Handling a Late Payment — Step 1 (role-gated arrears triage)
Personal SettingsPreferences (account notification masters), Notifications — Payment overdue alerts, Handling a Late Payment — Step 1 (per-user opt-outs)
Payments · Invoicing · FeesIntegrations (Hostkit / Invoice-xpress), Emails (payment reminders), Notifications — Payment overdue alerts, Handling a Late Payment — Step 1
ContractGeneral Information (logo), Categories (lease purpose), Preferences — Mandatory fields before contract signing, Handling a Late Payment — Step 1, Notifications — Payment overdue alerts
UtilitiesCategories (extra charges), Listings Step 3 (Bills Included ceilings)
CategoriesTenant categories (portal segments), Operations (ticket labels), Handling a Late Payment — Step 1 (penalty extra charges)
Tenant categoriesPreferences (portal toggles), Integrations (default for integrations), Handling a Late Payment — Step 1 (segment-filtered arrears)
ServicesPreferences (Allow to see services), Finance (reconciliation), Handling a Late Payment — Step 1 (portal service charges)
IntegrationsIntegration field capability (payload matrix), Listings → Channels (per-unit linking), Handling a Late Payment — Step 1, Notifications — Payment overdue alerts
ChatBotEmails (lifecycle mail), Inbox (portfolio WhatsApp triage), Handling a Late Payment — Step 1 (bot payment hand-offs)
AI / MCPUsers (account_settings.mcp + per-user overrides), Landlord MCP (HTTP /mcp clients), AI Chat (in-app assistant shares tool policy), AI usage API (landlord_chat spend)
EmailsPreferences (alert masters), ChatBot (WhatsApp channel), Handling a Late Payment — Step 1 (payment reminders), Notifications — Payment overdue alerts
PreferencesNotifications — Payment overdue alerts, Handling a Late Payment (operator Payments category rows)

Partner HTTP contracts configured alongside Integrations are documented in the API Reference hub — distinct from management UI deep links in Deep Links.

Pair with other Account Settings hub sections

This table is the primary go-live pairing matrix for Account Settings tabs — each sub-guide also opens with a First-time workspace setup tip, a Finding your way in this guide tip with section anchors, its own section cross-reference anchor, and a Deeper workflow reads subsection pairing operational workflows. Hub map: the Finding your way tip at the top of this page. Setup sequencing: Recommended setup order.

Use this table when you are configuring a new Vivin workspace — it maps Getting Started — Recommended Setup Sequence steps 1–12 to Account Settings tabs. Steps 13–15 open Listings, Bookings, and Tenants (not Account Settings). Full onboarding context, optional sections, and go-live verification: Getting Started — Recommended Setup Sequence and Onboarding a New Property — Step 7. After modules go live, pair each setup phase with operational workflows in Setup sequence after go-live (hub parity: Common Workflows — Setup sequence after go-live, Concepts — Setup sequence after go-live).

Setup stepAccount Settings tab
1General Information
2Preferences
3Users
4Owners
5Payments
6Invoicing
7Utilities
8Contract
9Categories
10Tenant categories
11Emails
12Integrations

Optional tabs configured during or after the core sequence — see Getting Started optional subsections: Services (add-on catalogue), ChatBot (tenant WhatsApp assistant), AI / MCP (Landlord MCP keys and tool permissions — Vivin-internal rollout), Subscription (Vivin platform billing), Personal Settings (per-user locale), and Integration field capability (read-only partner payload matrix).

Pair with other Account Settings hub sections

Steps 1–12 here map to Account Settings tabs; steps 13–15 open Listings, Bookings, and Tenants. Guided walkthrough: Onboarding a New Property. Workflow pairing after go-live: Setup sequence after go-live. Full pairing matrix: Account Settings — Section cross-reference.

Account Settings section cross-reference

Use this table when one Account Settings tab or setup step naturally leads into another guide — each row links to the docs you should read before or after the primary topic.

| Hub topic / settings area | Pair with these docs | | --------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Account Settings hub subsection index | Common Workflows hub subsection index (operational procedures), Introduction hub subsection index (platform overview), Getting Started hub subsection index (onboarding sections), Concepts hub subsection index (underlying models), Modules hub subsection index (screen workspaces), API hub subsection index (partner HTTP guides), FAQ subsection cross-reference (troubleshooting deep-dives), Support hub subsection index (escalation steps), Glossary deep-dive index (term definitions), Recommended setup order (steps 1–12 tab map), Tab cross-reference (go-live tab pairing) | | Recommended setup order | Getting Started — Recommended Setup Sequence, Tab cross-reference (go-live tab pairing), Onboarding a New Property (guided steps 4–12), Onboarding a New Property — Step 7 (go-live verification after steps 13–15), Getting Started — Section cross-reference, Support — Setup sequence escalation (when to file setup tickets), FAQ — Section cross-reference (troubleshooting hub), Glossary — Setup sequence vocabulary (setup labels), Setup sequence after go-live (which workflows follow each setup phase), Common Workflows — Setup sequence after go-live (workflow hub parity) | | Tab cross-reference | Recommended setup order (steps 1–12 tab map), per-tab section cross-reference anchors linked in the table above, Onboarding a New Property (property wizard after billing and contract tabs), Setup sequence after go-live | | Support-only browse shell | Using in-app support, Get Help & Support, Users and roles (support.module without editable settings tabs) | | Setup sequence after go-live | Getting Started — Recommended Setup Sequence (steps 1–15), Onboarding a New Property — Step 7, Support — Setup sequence escalation, Common Workflows — Setup sequence after go-live | | Documentation map & escalation | Introduction — Section cross-reference, FAQ — Section cross-reference, Support — Section cross-reference, Common Workflows hub cross-reference, Using in-app support | | Navigation & bookmarks | Management Frontend Deep Links, Create New menu, Getting Started — Bookmarkable routes, Interface language | | Tab cross-cuts (beyond the sidebar) | Tab cross-reference, Invoicing & Payments, Emails, Tenant categories | | Deeper concept reads | Payment Allocation, Tenant Portal, Integrations & Distribution, Automation & AI | | Deeper API reads | AI usage API (landlord_chat, utility_bill_extraction), Management session (operator JWT), Users and roles (account_settings.module) | | Deeper workflow reads | Common Workflows hub subsection index, Onboarding a New Property, Portfolio KPI review | | Recommended operator workflows | Common Workflows — Workflow cross-reference, Walkthrough media, Onboarding a New Property, Portfolio KPI review, Reject/revert mistaken receipts | | Modules shaped by Account Settings | Modules — Module cross-reference, Modules — Settings that shape modules, Support — Module documentation hubs | | Lockout catch-up after password recovery | Sign-in restored after password reset; onboarding, alert, or month-end backlog accumulated during lockout | Common Workflows — Lockout catch-up after password recovery, Getting Started — Lockout catch-up after password recovery, Resetting a Management User Password | | Walkthrough media | MP4 walkthroughs beside PNG screenshots | Common Workflows — Walkthrough media, Modules, Onboarding a New Property | | Notification row-click navigation | /notifications row-click after configuring alert masters | Common Workflows — Notification row-click navigation, Preferences — In-app notifications, Notifications module | | Payment alert to receivables triage | payment overdue after due-date and notification settings | Common Workflows — Payment alert to receivables triage, Invoicing & Payments, Handling a Late Payment — Step 1 | | Finance debt receivables triage | Total Debt / Debt Aging after due-date and approval settings | Common Workflows — Finance debt receivables triage, Invoicing & Payments, Users and roles (Approve payments), FAQ — Finance debt receivables triage hub | | Handling a Late Payment collections | Receivables triage surfaces → Handling a Late Payment Steps 1–6 after due-date and Approve payments settings | Common Workflows — Handling a Late Payment collections hub, Invoicing & Payments, Users and roles, FAQ — Handling a Late Payment collections hub, Glossary — Handling a Late Payment collections hub (finance-overview-income-chart-debt-aging.png, notifications-row-navigate-to-booking-detail.png) | | Finance Income status drill-down | Income segment reads after due-date / approval settings shape receivables KPIs | Common Workflows — Finance Income status drill-down, Invoicing & Payments, FAQ — Finance Income status drill-down hub (finance-overview-income-status-in-debt-modal.png, finance-overview-income-drill-down-flow.mp4) | | Cash flow forecast drill-down | Collections history after payment-deadline and approval settings | Common Workflows — Cash flow forecast drill-down, Finance Income status drill-down, FAQ — Cash flow forecast drill-down hub (finance-overview-cash-flow-all-payments-modal.png, finance-overview-cash-flow-drill-down-flow.mp4) | | Same-day turnover coordination | Access codes and turnover defaults before shared-unit handover | Common Workflows — Same-day turnover coordination, Preferences, Listings, FAQ — Same-day turnovers | | Check-out final utilities handoff | Charge Time / utility connections before first departure final overages | Common Workflows — Check-out final utilities handoff, Onboarding a New Property — Step 4, Services, FAQ — Check-out final utilities handoff | | Check-out collections before refund | Invoicing & Payments due dates and Approve payments before departure-week collections | Common Workflows — Check-out collections before refund, Invoicing & Payments, Handling a Late Payment, FAQ — Check-out collections before refund (workflows-check-out-coordination-flow.mp4, finance-contract-values-in-debt-filter.png) | | Check-out ledger cleanup before refund | Approve payments and credit-note pacing before duplicate cleanup on departure week | Common Workflows — Check-out ledger cleanup before refund, Users and roles, Invoicing & Payments, FAQ — Check-out ledger cleanup before refund (bookings-detail-transactions-revert-modal-info-banner.png, finance-transactions-bulk-reject-selected-bar.png) | | Check-out vs cancellation | Deposit and cancellation policies shape Ended vs Canceled routing | Common Workflows — Check-out vs cancellation, Invoicing & Payments, Managing a Check-out, Cancelling a Booking, FAQ — Check-out vs cancellation (workflows-cancel-booking-refund-modal-flow.mp4, bookings-list-canceled-tab.png) | | Cancellation collections before void | Invoicing & Payments due dates and Approve payments before pre-cancel settlement | Common Workflows — Cancellation collections before void, Invoicing & Payments, Cancelling a Booking, FAQ — Cancellation collections before void (finance-contract-values-in-debt-filter.png, bookings-cancel-booking-modal-refund-types.png, workflows-cancel-booking-refund-modal-flow.mp4) | | Wrong tenant on a booking | Duplicate email/NIF tenants and Tenant category defaults before import profile mistakes | Common Workflows — Wrong tenant on a booking, Tenant categories, Bookings — Change tenant, FAQ — Wrong tenant on a booking (bookings-detail-change-tenant-control.png, bookings-detail-change-tenant-flow.mp4) | | Cancel Booking vs Delete Booking | Integration in-payment guards (#2076) before Delete Booking on channel imports | Common Workflows — Cancel Booking vs Delete Booking, Invoicing & Payments, Bookings — Delete Booking, FAQ — Cancel Booking vs Delete Booking (bookings-cancel-booking-modal-refund-types.png, workflows-cancel-booking-refund-modal-flow.mp4) | | Portfolio retirement decisions | Tenant category defaults and in-payment rules before building Archive or reservation cleanup | Common Workflows — Portfolio retirement decisions, Tenant categories, Listings — Archived properties, FAQ — Portfolio retirement decisions (listings-archived-populated-table.png, listings-archived-unarchive-sidebar.png, finance-transactions-type-summary-cards.png) | | Archive property (building-level) | Building Archive / Unarchive on Listings — settings defaults before portfolio sunsetting | Common Workflows — Archive property (building-level), Listings — Archived properties, Manual block hygiene, FAQ — Archive a property (listings-archived-populated-table.png, listings-archived-unarchive-sidebar.png) | | Utility overage collections | Charge Time / utility Connections before first monthly overage collections | Common Workflows — Utility overage collections, Onboarding a New Property — Step 4, Entering Monthly Utility Bills, Services | | Property setup to first arrival handoff | Tenant category / Access Lockers before first arrival week on go-live inventory | Common Workflows — Property setup to first arrival handoff, Onboarding a New Property — Step 4, Tenant categories, Integrations, FAQ — Property setup to first arrival handoff | | New inventory to first booking handoff | Tenant category / channel integrations before first Upcoming reservation on go-live inventory | Common Workflows — New inventory to first booking handoff, Onboarding a New Property — Step 4, Integrations, Tenant categories, FAQ — New inventory to first booking handoff | | Confirmation to check-in handoff | Tenant category / tenant-portal contract rules before Upcoming → arrival week handoff | Common Workflows — Confirmation to check-in handoff, Tenant categories, Preferences, FAQ — Confirmation to check-in handoff (bookings-detail-contract-method-of-payments.png, workflows-operations-check-in-out-planning-view.png) | | Check-in to check-out handoff | Default check-in / check-out times and auto check-out tickets before departure week | Common Workflows — Check-in to check-out handoff, General Information, Listings — Maintenances tab, FAQ — Check-in to check-out handoff (operations-check-in-out-check-outs-next-7-days.png, bookings-timeline-view.png) | | Occupancy KPI to block hygiene handoff | Vacant Unit Preference and Analytics module permission before blaming holds on KPI dips | Common Workflows — Occupancy KPI to block hygiene handoff, Preferences, Users and roles, Portfolio KPI review, Manual block hygiene, FAQ — Occupancy KPI to block hygiene handoff hub (analytics-kpi-occupancy-tab.png, audit-manual-blocks-workspace.png) | | Confirmation alert triage | Upcoming alerts after go-live reservations | Common Workflows — Confirmation alert triage, Processing a New Booking — Step 5b, Pending manual receipt approval | | Portfolio segmentation by tenant category | Review only corporate, short-stay, or unassigned tenants across reservations, receivables, and profiles | Common Workflows — Portfolio segmentation by tenant category, Tenant categories, Glossary — Tenant category | | Pending manual receipt approval | Recorded bank transfers still pending until Approve payments | Common Workflows — Pending manual receipt approval, Users and roles (Approve payments permission), Finance — Pending manual payments, FAQ — Manual receipt still pending | | Reject/revert mistaken receipts | Duplicate bank transfers and invoiced reject/revert | Common Workflows — Reject/revert mistaken receipts, Payment Allocation — Correcting mistaken receipts, Invoicing & Payments, Users and roles | | Month-end invoicing (fixed date) | Invoicing & Payments fixed Invoice date before month-end bulk Issue allocation | Common Workflows — Month-end invoicing (fixed date), Invoicing & Payments — Default invoice date, Finance — Month-end invoicing with a fixed date, FAQ — Month-end invoicing (fixed date) hub (settings-invoicing-invoice-date-toggle.png, finance-transactions-bulk-toolbar-fixed-invoice-date-banner.png) | | Bulk Hostkit invoicing | Integrations — Hostkit keys + Invoicing & Payments — Hostkit invoice series before bulk Issue allocation | Common Workflows — Bulk Hostkit invoicing, Integrations — Hostkit API pacing, Invoicing & Payments — Hostkit invoice series, FAQ — Bulk Hostkit invoicing hub (finance-transactions-bulk-selection-bar.png, settings-invoicing-hostkit-series.png) | | Rent reduction after invoicing | Invoicing & Payments export + Hostkit Issue credit notes after external rent relief on live bookings | Common Workflows — Rent reduction after invoicing, Invoicing & Payments — Default invoice date, Integrations — Hostkit API pacing, FAQ — Lower rent below invoiced (bookings-detail-change-monthly-rent-modal.png, bookings-rent-reduction-invoiced-floor-flow.mp4) | | Key glossary terms | Glossary cluster cross-reference, Glossary — Setup sequence vocabulary, Payment Allocation |

Pair with other Account Settings hub sections

Use this table when one Account Settings tab or setup step naturally leads into another guide — pair with Tab cross-reference for per-tab go-live pairing and Recommended setup order for the steps 1–12 map. Each Related subsection below has a row in this table. Full hub map: the Finding your way tip at the top of this page.


Platform overview and documentation map: Introduction (hub: Key Platform Capabilities, Introduction — Section cross-reference). First-time setup hub: Getting Started — Recommended Setup Sequence (steps 1–12 tab map: Recommended setup order; workflow pairing: Setup sequence after go-live). Definitions behind linked terms: Glossary (hub: Glossary cluster cross-reference, Setup sequence vocabulary, Setup sequence after go-live). Troubleshooting during setup: FAQ & Troubleshooting (hub: FAQ — Section cross-reference, Setup sequence after go-live). Escalation when self-serve docs do not unblock setup: Get Help & Support (hub: Support — Section cross-reference, Setup sequence after go-live, Setup sequence escalation).

Pair with other Account Settings hub sections

Related below is the documentation map when settings changes span modules, concepts, workflows, API integration, or escalation paths. Pair Setup sequence after go-live with Getting Started — Recommended Setup Sequence; pair Documentation map & escalation with Introduction — Section cross-reference. Each Related subsection has a row in Account Settings — Section cross-reference above.

Account Settings hub subsection index

Pair with other Account Settings hub sections

This index pairs sidebar sections and Related hub subsections — use it when configuration spans multiple tabs, modules, workflows, or escalation hubs. Full pairing matrix: Account Settings — Section cross-reference.

SubsectionWhen to open itPair with
AccountCompany identity, subscription, preferences, personal localeGeneral Information, Preferences, Personal Settings
TeamMember access and owner registryUsers, Owners
BillingPayment deadlines, invoicing, fees, contract templatesInvoicing & Payments, Contract
PropertyListing categories, tenant segments, services catalogueCategories, Tenant categories, Services
SystemIntegrations, chatbot, lifecycle emailsIntegrations, ChatBot, Emails
Support (Vivin support tickets)Vivin product tickets and support-only browse shellUsing in-app support, Get Help & Support
Tab cross-referenceGo-live tab pairing matrixRecommended setup order (steps 1–12 map)
Recommended setup orderSetup steps 1–12 tab mapGetting Started — Recommended Setup Sequence, Onboarding a New Property
Setup sequence after go-livePost-setup workflows after steps 1–15Common Workflows hub subsection index, Modules hub subsection index
Documentation map & escalationCross-hub navigation during troubleshootingIntroduction — Section cross-reference, FAQ — Section cross-reference, Support — Section cross-reference
Navigation & bookmarksDeep links and profile routesManagement Frontend Deep Links, My Profile
Tab cross-cuts (beyond the sidebar)Cross-tab defaults (notifications, deposits, tenant segments)Preferences, Invoicing & Payments, Tenant categories
Deeper concept readsUnderlying models behind settingsConcepts hub subsection index, Payment Allocation, Tenant Portal
Deeper API readsOperator JWT ledger and month-end AI cost reviewAI usage API, Management session, Users and roles (account_settings.module), Modules — Deeper API reads
Deeper workflow readsStep-by-step procedures shaped by settings tabsCommon Workflows hub subsection index, sub-guide anchors (for example General Information, Integrations, Emails), Onboarding a New Property
Recommended operator workflowsDay-to-day procedures after go-liveCommon Workflows hub subsection index, Workflow cross-reference, Onboarding a New Property
Modules shaped by Account SettingsScreen docs for each configured defaultModules hub subsection index, Listings, Finance
Lockout catch-up after password recoverySign-in restored after password reset; setup tabs blocked during lockoutCommon Workflows — Lockout catch-up after password recovery, Getting Started — Lockout catch-up after password recovery, Resetting a Management User Password
Walkthrough mediaMP4 walkthroughs beside PNG screenshotsCommon Workflows — Walkthrough media, Modules, Onboarding a New Property
Notification row-click navigationAlert masters configured — row-click triageCommon Workflows — Notification row-click navigation, Preferences — In-app notifications, Notification triage
Payment alert to receivables triagepayment overdue after due-date settingsCommon Workflows — Payment alert to receivables triage, Invoicing & Payments, Handling a Late Payment — Step 1
Finance debt receivables triageDebt Aging after due-date and Approve payments settingsCommon Workflows — Finance debt receivables triage, Invoicing & Payments, Pending manual receipt approval
Handling a Late Payment collectionsTriage surfaces → collections Steps 1–6 after settings configure due datesCommon Workflows — Handling a Late Payment collections hub, Finance debt receivables triage, Pending manual receipt approval, FAQ — Handling a Late Payment collections hub
Finance Income status drill-downIncome segments after due-date settingsCommon Workflows — Finance Income status drill-down, Invoicing & Payments, Pending manual receipt approval
Cash flow forecast drill-downCollections history after approval settingsCommon Workflows — Cash flow forecast drill-down, Finance Income status drill-down, Invoicing & Payments
Same-day turnover coordinationShared-unit handover after access and listing defaultsCommon Workflows — Same-day turnover coordination, Preferences, Managing a Check-in
Check-out final utilities handoffCharge Time and utility connections before first departure overagesCommon Workflows — Check-out final utilities handoff, Onboarding a New Property — Step 4, Entering Monthly Utility Bills
Check-out collections before refundDue dates and Approve payments before departure-week collectionsCommon Workflows — Check-out collections before refund, Invoicing & Payments, Handling a Late Payment, Managing a Check-out
Check-out ledger cleanup before refundApprove payments before duplicate cleanup on departure weekCommon Workflows — Check-out ledger cleanup before refund, Users and roles, Reject/revert mistaken receipts, FAQ — Check-out ledger cleanup before refund
Check-out vs cancellationDeposit and cancellation defaults before lifecycle exit routingCommon Workflows — Check-out vs cancellation, Invoicing & Payments, Managing a Check-out, Cancelling a Booking, FAQ — Check-out vs cancellation
Cancellation collections before voidDue dates and Approve payments before pre-cancel settlementCommon Workflows — Cancellation collections before void, Invoicing & Payments, Cancelling a Booking, FAQ — Cancellation collections before void
Wrong tenant on a bookingTenant category and duplicate-tenant setup before profile link mistakesCommon Workflows — Wrong tenant on a booking, Tenant categories, Bookings — Change tenant, FAQ — Wrong tenant on a booking
Cancel Booking vs Delete BookingApprove payments and provider in-payment rules before Delete BookingCommon Workflows — Cancel Booking vs Delete Booking, Invoicing & Payments, Users and roles, FAQ — Cancel Booking vs Delete Booking
Portfolio retirement decisionsTenant category and payment rules before building Archive or cleanupCommon Workflows — Portfolio retirement decisions, Tenant categories, Manual block hygiene, FAQ — Portfolio retirement decisions
Archive property (building-level)Building Archive / Unarchive after settings go-live verificationCommon Workflows — Archive property (building-level), Listings — Archived properties, FAQ — Archive a property, Glossary — Archived property
Utility overage collectionsUtility Connections and Charge Time before overage postingCommon Workflows — Utility overage collections, Onboarding a New Property — Step 4, Entering Monthly Utility Bills
Property setup to first arrival handoffTenant category and access defaults before first arrival weekCommon Workflows — Property setup to first arrival handoff, Onboarding a New Property — Step 4, Tenant categories, Managing a Check-in
New inventory to first booking handoffTenant category and channel defaults before first Upcoming reservationCommon Workflows — New inventory to first booking handoff, Onboarding a New Property — Step 4, Integrations, Processing a New Booking
Confirmation to check-in handoffTenant category and portal contract defaults before arrival weekCommon Workflows — Confirmation to check-in handoff, Tenant categories, Preferences, Processing a New Booking
Check-in to check-out handoffDefault times and auto check-out tickets before departure weekCommon Workflows — Check-in to check-out handoff, General Information, Managing a Check-in, Managing a Check-out
Occupancy KPI to block hygiene handoffVacant Unit Preference and Analytics permission before KPI dip triageCommon Workflows — Occupancy KPI to block hygiene handoff, Preferences, Users and roles, Portfolio KPI review
Confirmation alert triageUpcoming alerts after first reservationsCommon Workflows — Confirmation alert triage, Pending manual receipt approval, Processing a New Booking
Portfolio segmentation by tenant categoryReview only one tenant segment across Bookings, Finance, and TenantsCommon Workflows — Portfolio segmentation by tenant category, Tenant categories, Glossary — Tenant category
Pending manual receipt approvalRecorded bank transfers still pending until approvalCommon Workflows — Pending manual receipt approval, Users and roles, Finance — Pending manual payments
Reject/revert mistaken receiptsDuplicate or invoiced receipt cleanupCommon Workflows — Reject/revert mistaken receipts, Payment Allocation — Correcting mistaken receipts, Invoicing & Payments
Month-end invoicing (fixed date)Fixed Invoice date before month-end bulk exportCommon Workflows — Month-end invoicing (fixed date), Invoicing & Payments — Default invoice date, Portfolio KPI review — Step 7, FAQ — Month-end invoicing (fixed date) hub
Bulk Hostkit invoicingHostkit bulk Issue allocation pacing after keys and series are savedCommon Workflows — Bulk Hostkit invoicing, Using in-app support — Bulk Hostkit invoicing, FAQ — Bulk Hostkit invoicing hub, FAQ — Bulk Hostkit invoicing slow
Rent reduction after invoicingInvoiced floor after month-end export — booking workspace repricingCommon Workflows — Rent reduction after invoicing, Using in-app support — Rent reduction after invoicing, FAQ — Rent reduction after invoicing hub, FAQ — Lower rent below invoiced
Key glossary termsDefinitions cited on settings pagesGlossary deep-dive index, Glossary cluster cross-reference

Setup sequence after go-live

Pair with other Account Settings hub sections

Post-go-live pairing starts with Getting Started — Recommended Setup Sequence (steps 1–15) and Onboarding a New Property — Step 7. When a tab save or wizard step still blocks progress, continue to Support — Setup sequence escalation. Full pairing matrix: Account Settings — Section cross-reference.

Documentation map & escalation

Pair with other Account Settings hub sections
Pair with other Account Settings hub sections

Tab cross-cuts (beyond the sidebar)

Pair with other Account Settings hub sections

Cross-tab defaults here pair with Tab cross-reference (go-live tab pairing) and module surfaces in Modules shaped by Account Settings. Payment alerts: Notifications — Payment overdue alerts. Full pairing matrix: Account Settings — Section cross-reference.

Deeper concept reads

Pair with other Account Settings hub sections

Concept reads pair with Concepts hub subsection index and explain behaviour shaped by tabs in Tab cross-reference. Tenant-facing: Tenant Portal. External AI: Landlord MCP vs Tenant MCP. Full pairing matrix: Account Settings — Section cross-reference.

Deeper API reads

Pair with other Account Settings hub sections
Pair with other Account Settings hub sections

Workflow bullets apply settings configured on tabs above — pair with Common Workflows — Workflow cross-reference and Onboarding a New Property (guided steps 4–12). Full pairing matrix: Account Settings — Section cross-reference.

Deeper workflow reads

Pair with other Account Settings hub sections

Workflow reads pair with Common Workflows hub subsection index and Workflow cross-reference. Each workflow sub-guide reciprocates with [Deeper workflow reads](../settings/index.md#deeper-workflow-reads) anchors on Account Settings bullets; each Account Settings sub-guide has its own Deeper workflow reads subsection (for example Integrations, Tenant categories) — hub parity: Account Settings hub — Deeper workflow reads. Full pairing matrix: Account Settings — Section cross-reference.

Modules shaped by Account Settings

Pair with other Account Settings hub sections

Lockout catch-up after password recovery

Pair with other Account Settings hub sections

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

Notification row-click navigation

Pair with other Account Settings hub sections

Alert masters on Preferences — In-app notifications shape which rows appear on /notifications before row-click triage. Hub parity: Common Workflows — Notification row-click navigation. Full pairing matrix: Account Settings — Section cross-reference.

Payment alert to receivables triage

Pair with other Account Settings hub sections

Due dates on Invoicing & Payments and alert masters on Preferences shape payment overdue rows that row-click into bookings. Hub parity: Common Workflows — Payment alert to receivables triage. Full pairing matrix: Account Settings — Section cross-reference.

Finance debt receivables triage

Pair with other Account Settings hub sections

Due dates on Invoicing & Payments and Approve payments on Users and roles shape when Total Debt and Debt Aging reflect recorded transfers — clear amber Pending before month-end sign-off. Hub parity: Common Workflows — Finance debt receivables triage. Full pairing matrix: Account Settings — Section cross-reference.

Handling a Late Payment collections

SymptomTriage surfaceCollections step
payment overdue alert after due-date changeRow-click on /notificationsHandling a Late Payment — Step 1
Ranked debtors after settings go-liveFinance → Overview → Debt AgingStep 1 after booking open
Total Debt unchanged after transferPending manual receipt approvalStep 4b
Teammate lacks Approve paymentsUsers and rolesRole PermissionsStep 6 Vivin support ticket

Finance Overview — Debt Aging panel with overdue buckets and top debtors for prioritizing late payments

Finance Income status drill-down

Pair with other Account Settings hub sections

Due-date and Approve payments settings shape Income chart Scheduled / In debt segments — pair segment drill-down with Finance debt receivables triage for Top debtors. Hub parity: Common Workflows — Finance Income status drill-down. Full pairing matrix: Account Settings — Section cross-reference.

Cash flow forecast drill-down

Pair with other Account Settings hub sections

Payment approval settings gate when collections appear on Cash flow forecast month bars — distinct from Income status segments and Dashboard rent due chart. Hub parity: Common Workflows — Cash flow forecast drill-down. Full pairing matrix: Account Settings — Section cross-reference.

Same-day turnover coordination

Pair with other Account Settings hub sections

Access defaults on Preferences and unit access fields configured during Onboarding a New Property — Step 4 shape turnover-week key handover — finish outgoing Managing a Check-out — Step 2 before incoming Step 4. Hub parity: Common Workflows — Same-day turnover coordination. Full pairing matrix: Account Settings — Section cross-reference.

Check-out final utilities handoff

Pair with other Account Settings hub sections

Charge Time on property settings and utility Connections configured during Onboarding a New Property — Step 4 / Step 6 shape when final-cycle overage lines appear on Payment Plan before Managing a Check-out — Step 6. Hub parity: Common Workflows — Check-out final utilities handoff. Full pairing matrix: Account Settings — Section cross-reference.

Check-out collections before refund

Pair with other Account Settings hub sections

Invoicing & Payments due dates and Approve payments on Users and roles shape when departure-week rent/fee lines stay In Debt on Payment Plan before Managing a Check-out — Step 6 unlocks Ready To Refund — distinct from utility Check-out final utilities handoff. Hub parity: Common Workflows — Check-out collections before refund. Full pairing matrix: Account Settings — Section cross-reference.

Check-out ledger cleanup before refund

Pair with other Account Settings hub sections

Approve payments on Users and roles and Invoicing & Payments credit-note pacing shape duplicate cleanup before Managing a Check-out — Step 6 unlocks Ready To Refund — distinct from rent Check-out collections before refund. Hub parity: Common Workflows — Check-out ledger cleanup before refund. Full pairing matrix: Account Settings — Section cross-reference.

Check-out vs cancellation

Pair with other Account Settings hub sections

Invoicing & Payments deposit policies and cancellation terms on General Information shape whether operators route to Managing a Check-out (Ended) or Cancelling a Booking (Canceled) — distinct from departure-week Check-out collections before refund and pre-cancel Cancellation collections before void. Hub parity: Common Workflows — Check-out vs cancellation. Full pairing matrix: Account Settings — Section cross-reference.

Cancellation collections before void

Pair with other Account Settings hub sections

Invoicing & Payments due dates and Approve payments on Users and roles shape pre-cancel settlement before Cancelling a Booking — Step 4 — distinct from departure-week Check-out collections before refund and duplicate Check-out ledger cleanup before refund. Hub parity: Common Workflows — Cancellation collections before void. Full pairing matrix: Account Settings — Section cross-reference.

Wrong tenant on a booking

Pair with other Account Settings hub sections

Tenant categories defaults on Tenant categories and duplicate email/NIF tenants in the account shape how channel imports and manual Add booking pickers resolve profiles — when the reservation is valid but linked to the wrong person, operators use Change tenant on Contract Info, not tenant master-data edits or Delete Booking. Hub parity: Common Workflows — Wrong tenant on a booking. Full pairing matrix: Account Settings — Section cross-reference.

Cancel Booking vs Delete Booking

Pair with other Account Settings hub sections

Invoicing & Payments provider-platform in-payment rules and Approve payments on Users and roles shape whether operators can run Delete Booking on channel imports (#2076) or must Cancel booking when ledger history matters (#1897) — distinct from wrong-profile Wrong tenant on a booking. Hub parity: Common Workflows — Cancel Booking vs Delete Booking. Full pairing matrix: Account Settings — Section cross-reference.

Portfolio retirement decisions

Pair with other Account Settings hub sections

Tenant category and integration defaults on Tenant categories shape which reservations remain Upcoming on a building being retired — pair Manual block hygiene and Invoicing & Payments provider in-payment rules (#2076) before Archive property or Delete Booking on channel imports — distinct from Cancel Booking vs Delete Booking reservation-only scope. Hub parity: Common Workflows — Portfolio retirement decisions. Full pairing matrix: Account Settings — Section cross-reference.

Archive property (building-level)

Pair with other Account Settings hub sections

Tenant category defaults on Tenant categories and go-live verification on Onboarding a New Property — Step 7 shape which buildings are ready for Archive property sunsetting — pair Manual block hygiene before building Archive and Portfolio retirement decisions when scope is unclear. Hub parity: Common Workflows — Archive property (building-level). Full pairing matrix: Account Settings — Section cross-reference.

Utility overage collections

Pair with other Account Settings hub sections

Charge Time on property settings and utility Connections configured during Onboarding a New Property — Step 4 / Step 6 shape when mid-stay overage lines post on Payment Plan before Handling a Late Payment — Step 1 collections. Hub parity: Common Workflows — Utility overage collections. Full pairing matrix: Account Settings — Section cross-reference.

Property setup to first arrival handoff

Pair with other Account Settings hub sections

Tenant category defaults on Tenant categories and property-level Access Lockers / Nuki routing on Integrations must match Onboarding a New Property — Step 4 before Managing a Check-in — Step 1 on go-live inventory. Hub parity: Common Workflows — Property setup to first arrival handoff. Full pairing matrix: Account Settings — Section cross-reference.

New inventory to first booking handoff

Pair with other Account Settings hub sections

Tenant category defaults on Tenant categories and channel routing on Integrations must match Onboarding a New Property — Step 4 before Processing a New Booking — Step 1 on go-live inventory — finish Step 7 Listings verify before manual Add booking or channel duplicate checks. Hub parity: Common Workflows — New inventory to first booking handoff. Full pairing matrix: Account Settings — Section cross-reference.

Confirmation to check-in handoff

Pair with other Account Settings hub sections

Tenant category defaults on Tenant categories and tenant-portal contract rules on Preferences shape Upcoming portal gates — confirm both match Processing a New Booking — Step 6 before Managing a Check-in — Step 1. Hub parity: Common Workflows — Confirmation to check-in handoff. Full pairing matrix: Account Settings — Section cross-reference.

Check-in to check-out handoff

Pair with other Account Settings hub sections

Default check-in / check-out times on General Information and per-property Maintenances auto-ticket toggles on Listings — Maintenances tab shape departure-week turnover planning after Managing a Check-in — Step 4. Confirm before Managing a Check-out — Step 1. Hub parity: Common Workflows — Check-in to check-out handoff. Full pairing matrix: Account Settings — Section cross-reference.

Occupancy KPI to block hygiene handoff

Pair with other Account Settings hub sections

Vacant Unit Preference on Preferences and the Analytics module permission on Users and roles shape how Dashboard Vacant Units compares to Analytics Occupancy — confirm both before Portfolio KPI review — Step 3 blames stale holds. When the dip tracks one tenant category, use Tenant categories — not Manual block hygiene. Hub parity: Common Workflows — Occupancy KPI to block hygiene handoff. Full pairing matrix: Account Settings — Section cross-reference.

Confirmation alert triage

Pair with other Account Settings hub sections

Upcoming Booking created / Payment received alerts appear after go-live reservations — finish confirmation Steps 5b / 6 before bulk-clear on /notifications. Hub parity: Common Workflows — Confirmation alert triage. Full pairing matrix: Account Settings — Section cross-reference.

Walkthrough media

Pair with other Account Settings hub sections

MP4 clips complement PNG screenshots on workflow and module guides — start at Common Workflows — Walkthrough media. Hub parity: Common Workflows — Walkthrough media. Full pairing matrix: Account Settings — Section cross-reference.

  • Common Workflows — Walkthrough media — Canonical MP4 index for step-by-step operator guides
  • Onboarding a New Property — Property wizard MP4 beside setup steps 4–12 on Account Settings tabs
  • ChatBot — Tenant assistant Save clip when pairing System tab configuration with Inbox
  • Using in-app support — Support drawer and new-ticket MP4 from Support (Vivin support tickets)
  • Modules — Module pages with embedded clips (Analytics tab switching, Operations mobile shell, Finance drill-downs)

Portfolio segmentation by tenant category

Pair with other Account Settings hub sections

Pending manual receipt approval

Pair with other Account Settings hub sections

Receipt approval pairs with Users and roles (Approve payments permission) and Invoicing & Payments payment priorities. Hub parity: Common Workflows — Pending manual receipt approval. Full pairing matrix: Account Settings — Section cross-reference.

Reject/revert mistaken receipts

Pair with other Account Settings hub sections

Month-end invoicing (fixed date)

Pair with other Account Settings hub sections

Invoicing & Payments fixed Invoice date on Default invoice date shapes every Fatura or Invoice-xpress document in a month-end batch — save the date before Finance → Transactions bulk Issue allocation, then turn Use today as invoice date back on after the batch. Pair Bulk Hostkit invoicing on the same amber toolbar banner. Hub parity: Common Workflows — Month-end invoicing (fixed date). Full pairing matrix: Account Settings — Section cross-reference.

Bulk Hostkit invoicing

Pair with other Account Settings hub sections

Integrations — Hostkit listing keys and Invoicing & Payments — Hostkit invoice series must be saved before month-end bulk Issue allocation — Vivin paces Hostkit and retries HTTP 429. Hub parity: Common Workflows — Bulk Hostkit invoicing. Full pairing matrix: Account Settings — Section cross-reference.

Rent reduction after invoicing

Pair with other Account Settings hub sections

Invoicing & Payments month-end export and Integrations — Hostkit keys shape when invoiced floor blocks Change monthly rent — external credit notes then Issue credit notes (N) on Finance → Transactions. Hub parity: Common Workflows — Rent reduction after invoicing. Full pairing matrix: Account Settings — Section cross-reference.

Key glossary terms

Pair with other Account Settings hub sections