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

Start with Search settings when you already know the control name, or browse System — Personal Settings and Global Settings (company identity, booking defaults, fees, and utilities) open first — then Team for access, Billing for payment and contract policy, and Tenant Portal for what tenants see. First-time administrators should complete Getting Started — Recommended Setup Sequence steps 1–12 on the tabs below before daily operations. 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. Habit-specific shortcuts live under Related below.

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. Workflow pairing after go-live: 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.

When a Settings tab needs a refresh — Directory-style modules and Account Settings tabs may ask you to Retry or refresh the page if a first load is incomplete. See Glossary — Directory list refresh and Glossary — Settings and profile recovery for Integrations, Emails, Services, Invoicing, Tenant categories, and My Profile.

The module is organised into sections of tabs in the left sidebar: System, Team, Billing, and Tenant Portal. 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). Use Search settings at the top of the sidebar to jump straight to a tab or a labelled card inside it.

The bare /settings URL opens Global Settings (English sidebar label). Company identity, branding, booking defaults, fees, and utilities live as cards on that tab — not as separate sidebar rows.

Account Settings — System sidebar with Global Settings selected (company, branding, and booking defaults cards)

Account Settings — Global Settings scrolled to Fee visibility, Custom fee names, and Utilities cards

Walkthrough: open Account Settings, move through System, Team, Billing, and Tenant Portal, then return to Global Settings.

Search settings​

Search settings sits at the top of the Account Settings sidebar on every settings tab. Type a name you remember from the screen to open that tab or card instead of scanning the sidebar groups.

  1. Open any Account Settings page — the box is labelled Search settings.
  2. Type part of a label, for example guarantor or ticket priority. Matching text highlights in teal. A second line shows tab · card (or the sidebar group when the result is a whole tab).
  3. Click a result, or use the arrow keys and Enter. Vivin opens that tab, scrolls to the control, and briefly highlights it. Escape clears the box.

Results only include tabs and cards your role can open. Search uses the labels in your current interface language, and still finds a setting through a small typo. If nothing matches, try another word from the screen — Guarantor lives on Global Settings → Booking Defaults; Ticket priority as a tab opens ChatBot.

Account Settings sidebar — Search settings box above System, Team, Billing, and Tenant Portal

Account Settings — Search settings results for guarantor, with Guarantor under Global Settings · Booking Defaults

Account Settings — Booking Defaults card after choosing Guarantor from Search settings (label highlighted)

Account Settings — Search settings results for ticket priority, with the ChatBot tab and Global Settings · Ticket Priorities rows

Walkthrough: type guarantor in Search settings, pick the result, and land on the Booking Defaults card with Guarantor highlighted.
Ask AI Chat where to open Account Settings

Not sure how to reach this hub from AI Chat? Ask AI Chat “Where do I open Account Settings to manage users, integrations, and workspace preferences?” — then open sidebar Settings (ai-chat-product-context-settings-reply.png, ai-chat-product-context-settings-flow.mp4). The assistant typically says Open Settings in the management app and points at System, Team, and Integrations.

Need the workspace configuration shell — users, integrations, and account defaults (not day-to-day portfolio modules)? Ask AI Chat “Where do I open Account Settings to manage users, integrations, and workspace preferences?” — then open sidebar Settings (ai-chat-product-context-settings-reply.png, ai-chat-product-context-settings-flow.mp4). The assistant typically says Open Settings in the management app and names System → Global Settings, Team, and Integrations. Canonical route: /settings.

AI Assistant — where to open Account Settings for users, integrations, and preferences

Walkthrough: ask AI Assistant where to open Account Settings for users, integrations, and preferences, then open sidebar Settings.
Pair with other Account Settings hub sections

The sidebar sections below (System, Team, Billing, Tenant Portal) 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.

System​

System is the first sidebar group. It holds personal and account-wide setup in one place (the former separate Settings and System headings are merged here).

Account Settings — System → Personal Settings selected in the sidebar

Account Settings — System → AI / MCP selected in the sidebar

Account Settings — System → ChatBot with Ticket priority subtab selected

Account Settings — System → Categories with the Tenants card in the category grid

Pair with other Account Settings hub sections

System tabs 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).

Operator AI Assistant (not in Account Settings)

Roles granted the AI / MCP row in Role permissions 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, Genius schedules, and tool scope on AI / MCP (/settings/mcp).

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 sidebar with Users selected

Account Settings — Team sidebar with Owners selected

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) and Tenant Portal (what tenants can edit) before go-live. Role-gated tabs: Users and roles.

Billing​

Fee toggles and invoice labels moved to Global Settings (Fee visibility / Custom fee names cards). VIVIN Invoicing issuer setup lives under Integrations when that connection is active — see VIVIN Invoicing.

Account Settings — Billing → Payments selected in the sidebar

Account Settings — Billing → Invoicing selected in the sidebar

Account Settings — Billing → Contract selected in the sidebar

Walkthrough: open Settings → Billing → Payments, then Invoicing and Contract, and return to Payments.
Pair with other Account Settings hub sections

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

Tenant Portal​

Everything that exists because the tenant-facing portal does — gathered in one sidebar group:

  • Portal settings — /settings/tenantPortal: default Tenant can edit, Portal modules, and Mandatory for contract signing toggles (moved here from Global Settings)
  • Services — Tenant services catalogue (cleaning, gym, parking, etc.)
  • FAQs — FAQ catalogue and FAQ Generator at /settings/faqs — AI drafts from WhatsApp / email / IF/THEN history; published rows appear on portal Requests (faq_generation on AI usage API)

Account Settings — Tenant Portal → Portal settings with edit and module toggles

Account Settings — Tenant Portal → Services catalogue

Pair with other Account Settings hub sections

Portal tabs pair with Portal settings (account-wide edit / module / signing gates), Tenant categories (segment overrides on the Categories Tenants card), ChatBot (tenant WhatsApp), and the concept guide Tenant Portal.

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 subtitle — Use 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

Your personal profile is managed separately via My Profile at platform.vivin.app/profile (or header user menu → My 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.

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, Portal settings, 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 · VIVIN Invoicing · FeesIntegrations (VIVIN Invoicing / Hostkit / Invoice-xpress / NetSuite), Emails (payment reminders), Notifications — Payment overdue alerts, Handling a Late Payment — Step 1
ContractGeneral Information (logo), Categories (lease purpose), Portal settings — 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 categoriesPortal settings (account-wide portal toggles), Integrations (default for integrations), Handling a Late Payment — Step 1 (segment-filtered arrears)
ServicesPortal settings (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), Genius (scheduled-report domain policy), AI usage API (landlord_chat spend)
GeniusAI / MCP (Scheduled reports tool permissions), AI Chat / Automation & AI — Scheduled reports (same schedule rows), Users (WhatsApp delivery phone), ChatBot → Bot Status (Genius WhatsApp connection card — separate from tenant WhatsApp)
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 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.

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

Optional tabs configured during or after the core sequence — see Getting Started optional subsections: Portal settings, Services, and FAQs under Tenant Portal, ChatBot (tenant WhatsApp assistant, including Ticket priority and the General subtab with the WhatsApp send confirmation), AI / MCP (Landlord MCP keys, Genius schedules, and tool permissions — opens for roles granted the AI / MCP row), Subscription (Vivin platform billing), Personal Settings (per-user locale), and Integration field capability (partner payload matrix on Integrations cards).

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.

Account Settings section cross-reference​

Use the sections above for this settings area. Related setup pages are linked from Related below when present, or from Account Settings.

Account Settings hub subsection index​

Pair with other Account Settings hub sections

Use the sidebar sections below when configuration spans multiple tabs. Habit shortcuts live under Related.

SubsectionWhen to open itPair with
Search settingsJump to a tab or card by nameGlobal Settings, Ticket priority, FAQ — Search settings
SystemPersonal locale, Global Settings, integrations, emailsGlobal Settings, General Information, Integrations, AI / MCP, Emails
TeamMember access and owner registryUsers, Owners
BillingPayment deadlines, invoicing VAT, contract templatesInvoicing & Payments, Contract
Tenant PortalPortal edit toggles, services catalogue, FAQ cataloguePortal settings, Services, FAQs, Tenant Portal concept
Support (Vivin support tickets)Vivin product ticketsUsing in-app support, Get Help & Support
Tab cross-referenceGo-live tab pairingRecommended setup order
Recommended setup orderSetup steps 1–12 tab mapGetting Started — Recommended Setup Sequence, Onboarding a New Property
Setup sequence after go-livePost-setup workflowsCommon Workflows, Modules
Documentation map & escalationCross-hub navigationFAQ, Get Help & Support
Key glossary termsDefinitions cited on settings pagesGlossary

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.

Documentation map & escalation​

Pair with other Account Settings hub sections

Tab cross-cuts (beyond the sidebar)​

Pair with other Account Settings hub sections

Deeper concept reads​

Pair with other Account Settings hub sections

Tenant-facing: Tenant Portal. External automation: Landlord MCP and Tenant MCP.

Deeper API reads​

Pair with other Account Settings hub sections

Permission gate: Users and roles (account_settings.module).

Pair with other Account Settings hub sections

Onboarding a New Property (guided steps 4–12).

Deeper workflow reads​

Modules shaped by Account Settings​

Pair with other Account Settings hub sections
  • Dashboard — Preferences in-app notification masters and post-login KPI snapshot
  • Analytics — Month-range portfolio KPI charts when Analytics module permission is granted from Users roles
  • Listings — Property wizard, Channels tab, Bills Included ceilings, and category tags from Categories
  • Properties workspace — Legacy /properties URL redirects into Listings when operators follow old bookmarks after setup
  • Booking engine details — Rich marketplace payload via the Full integration pill after Integrations and Integration field capability
  • Bookings — Contract generation, payment plans, and portal behaviour from Contract, Payments, and Tenant categories
  • Tenants — Tenant directory segmentation and Tenant category filters on profiles
  • Finance — VAT, deposit rules, payment priorities, and invoicing exports from Invoicing & Payments
  • Operations — Ticket labels, cash flows, and check-in/out coordination from Categories and Preferences
  • Sales — Channel manager connections after Integrations and per-listing Channels setup
  • Inbox — Portfolio WhatsApp triage paired with Chatbot and Emails lifecycle rules
  • Notifications — Full /notifications history gated by Preferences alert categories; operator Payment overdue alerts when scheduled charges are overdue
  • Audit — Manual Blocks and Discounts when fee and payment rules configured here affect live bookings
  • Utilities — Bills Included ceiling model and tenant overage charges from Utilities types and Listings Step 3
  • AI Chat — AI Assistant paired with Chatbot and Landlord MCP for portfolio Q&A

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​

Notification row-click navigation​

Payment alert to receivables triage​

Finance debt receivables triage​

Handling a Late Payment collections​

Finance Income status drill-down​

Cash flow forecast drill-down​

Same-day turnover coordination​

Check-out final utilities handoff​

Check-out collections before refund​

Check-out ledger cleanup before refund​

Check-out vs cancellation​

Cancellation collections before void​

Wrong tenant on a booking​

Cancel Booking vs Delete Booking​

Portfolio retirement decisions​

Archive property (building-level)​

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​

Portfolio segmentation by tenant category​

Pending manual receipt approval​

Reject/revert mistaken receipts​

Month-end invoicing (fixed date)​

Bulk Hostkit invoicing​

Rent reduction after invoicing​

Walkthrough media​

  • [Common Workflows — Operator habit hub

Key glossary terms​