Skip to main content

Interface Language

The management frontend supports multiple interface languages. In the current layout, language is not changed from Account Settings → Preferences (that tab covers booking defaults, notifications, tenant portal options, and related workspace defaults).

First-time workspace setup

Open Personal Settings (/settings/personal) any time after step 3 Users grants account_settings.personal — per-user locale and email opt-outs are optional during Getting Started — Recommended Setup Sequence steps 1–12. Full tab map: Recommended setup order. Workflow pairing after go-live: Account Settings — Setup sequence after go-live.

Finding your way in this guide

Open Where to find language controls first; per-user email opt-outs live under Your email preferences on the same tab. Supported locales: Supported language options. Non-linear operator habits (Lockout catch-up, Pending manual receipt approval, Reject/revert mistaken receipts, Portfolio segmentation by tenant category, Notification row-click navigation, Payment alert to receivables triage, Confirmation alert triage, Finance debt receivables triage, Finance Income status drill-down, Cash flow forecast drill-down) have matching Related subsections below. Full pairing matrix: Personal Settings section cross-reference · Account Settings — Tab cross-reference.

Deep links

Stable routes: /profile for My Profile, and the rest of Account Settings (including Preferences) under /settings/… as listed in Deep Links.

Pair with other Account Settings tabs

Personal Settings (/settings/personal) complements Users team access — grant account_settings.personal before operators can change locale here. Account-wide notification masters live on Preferences; per-user opt-outs are on this tab. After Resetting a Management User Password, refresh the management JWT before polling AI usage API — interface language here does not change ledger rows. Section-to-doc pairing: Personal Settings section cross-reference. Hub tab matrix: Account Settings — Tab cross-reference.

Where to find language controls​

Pair with other Personal Settings sections

Grant account_settings.personal on Users and roles — Role Permissions before teammates can open /settings/personal — desktop language chips and the mobile drawer control share the same saved preference. Full pairing matrix: Personal Settings section cross-reference.

Personal Settings (recommended — all screen sizes)​

This is the primary place to choose your interface language. The Personal Settings tab requires the account_settings.personal permission (see Users and roles — Role Permissions); without it, the tab is hidden and /settings/personal shows the standard settings permission state.

  1. Log in to platform.vivin.app.
  2. Click Account in the left sidebar (gear icon) to open Account Settings.
  3. In the settings sidebar, under Account, open Personal Settings — platform.vivin.app/settings/personal.
  4. In the Interface language card, pick English, Português, Español, or Italiano. The active language shows a checkmark on its chip.

Account Settings — Personal Settings tab with interface language chips

Walkthrough: on Personal Settings, switch the interface language chip (for example Português), then return to English so sidebar labels update with the same preference.

Access: Any signed-in user who can open Account Settings can use this tab (same visibility as other Account-section tabs you are permitted to see).

Your email preferences (same tab)​

Pair with other Personal Settings sections

Per-user toggles here layer on account masters from Preferences — Notifications & Emails — tenant-facing copy still comes from Emails Communication Rules. Full pairing matrix: Personal Settings section cross-reference.

Lower on Personal Settings, Your email preferences controls per-user email behaviour — it does not change account-wide templates or other team members.

Operator payment alerts vs. other notification rows

Payment notification emails controls your operator alerts when a tenant payment lands — mailbox email and in-app rows on /notifications and the Dashboard bell (summary Payment received from tenant …). Other notification types (bookings, tickets, system) are account-wide. Configure the account switch under Preferences → Notifications & Emails and your personal toggle here; see Glossary — Payment notification (operator) and Notifications — Payment received alerts.

  • Payment notification emails — When enabled, you receive email and in-app payment-received alerts when a tenant payment is received only if the account has Receive payment notifications turned on under Preferences → Notifications & Emails. Both layers must be enabled for you to see those messages.
  • Support ticket assigned — When enabled (default on), you receive an email when a Vivin support ticket is assigned to you (subject line [Support ticket #…] Assigned to you). The body includes the ticket title plus metadata — Account, Priority, Module, Status, and Tags — so you can triage from the mailbox without opening the thread (#2080). See ticket opens the support inbox in the management app (/?support=<ticketId>) for workspace operators; Vivin-internal assignees receive the admin UI link instead. Turn it off to stop those mailbox messages while still triaging tickets in the Help & Support drawer or Support inbox. This preference applies to Vivin support assignment emails only — not Operations maintenance tickets your team raises internally.
  • Service subscription emails — When enabled, you receive an email when a tenant orders or subscribes to a catalogue service from the Tenant Portal. This is separate from payment-notification emails and from the account-wide Services catalogue — it only controls whether your mailbox gets notified about new portal service requests.
  • BCC on tenant communications — Optional blind copies when the account sends certain tenant-facing emails, split into Booking lifecycle and Communications toggles (labels match the product).

For the account-level payment switch and other notification defaults, see Preferences.

Account Settings — Personal Settings with Your email preferences in view (payment, ticket-assigned, and service-subscription toggles plus BCC on tenant communications)

The screenshot shows the full Your email preferences card: your personal Payment notification emails switch (requires the account-level Receive payment notifications on Preferences), Support ticket assigned (per-user opt-out for assignment emails), Service subscription emails (portal service orders), plus optional BCC on tenant communications toggles for booking lifecycle and general communications emails sent to tenants.

Your in-app notifications (same tab)​

Pair with other Personal Settings sections

Category opt-outs cannot re-enable masters disabled under Preferences — In-app notifications — triage Notifications — Payment overdue alerts on Handling a Late Payment — Step 1 when payment rows still appear. Full pairing matrix: Personal Settings section cross-reference.

Lower on Personal Settings, Your in-app notifications controls which in-app alert categories you still see on the Dashboard bell and /notifications. These are per-user opt-out toggles — each defaults On (you receive the category unless you turn it off). They apply only to your user and cannot re-enable a category the account disabled under Preferences → In-app notifications.

Toggle (English UI)When On (default)Account master that must also be On
PaymentsYou see payment-received in-app rows when you are in the payment alert audiencePreferences → In-app notifications → Payments and Receive payment notifications
Service requestsYou see portal service order and cancellation pingsPreferences → In-app notifications → Service requests
Scheduled bookingsYou see scheduled booking success and failure alertsPreferences → In-app notifications → Scheduled bookings
Inbox messagesYou see inbound WhatsApp, email, and chatbot message notificationsPreferences → In-app notifications → Inbox messages

Toggles save immediately when you flip them (no separate Save button on this card). To stop mailbox payment emails while keeping in-app payment rows, use Payment notification emails above — email and in-app audience for payments are configured separately from these category opt-outs.

Account Settings — Personal Settings with Your in-app notifications card (Payments, Service requests, Scheduled bookings, Inbox messages opt-out toggles)

Screenshot freshness

Your in-app notifications section capture refreshed 2026-06-23 18:15 UTC (VIVIN_DOCS_BASE_URL=http://localhost:5173 VIVIN_DOCS_RECORD_API=$VITE_API_BASE_URL npx tsx tools/capture-settings-in-app-notifications-screenshots.ts).

Module tab order (same tab)​

Pair with other Personal Settings sections

Saved tab order is per user — identity fields on My Profile (/profile) and bookmarkable routes in Deep Links — Account Settings still open the tab named in the URL path. Full pairing matrix: Personal Settings section cross-reference.

Lower on Personal Settings, the Tab order card lets each signed-in user drag tabs into a preferred order for modules where the product exposes a tab strip. The order is saved per user (not account-wide) and applies to the tab bar in that module; URLs still open the tab named in the path (for example /sales/channels always lands on Channels).

ModuleTabs you can reorder (English labels)
BookingsList, Timeline
SalesOverview, Pricing, Channels
FinanceOverview, Income, Contract values, and (when your role includes payment approval) Transactions, Payouts, Deposits
UtilitiesOverview, Bills, Connections, Timeline, Allocations, Cost map
OperationsOverview, Schedule (Vivin internal operators), Tickets, Check-in / Check-out (when permitted), Cash flows

Use Save order after rearranging one or more modules. Reset to default on a module heading restores only that module’s tab sequence. Modules you cannot access (missing module permission) do not appear in the card.

Account Settings — Personal Settings Tab order card with drag handles for Finance, Utilities, and Operations tabs

Mobile sidebar (compact switch)​

On narrow viewports (below the desktop breakpoint), open the main menu (top-left) to show the left drawer. At the bottom, next to Logout, a compact control shows the current language code (for example EN) and opens a short list of supported languages. It updates the same preference as Personal Settings.

Mobile navigation drawer open with compact language control next to Logout

Desktop vs mobile

On desktop widths, the sidebar footer shows Account and Logout only — there is no compact language code beside Logout. Use Personal Settings (above) to change language on a laptop or wide monitor. The mobile drawer control is the quick switch when you are on a phone or narrow layout.

Legacy documentation paths

Older guides referred to a top-right header user menu for language. That control is not part of the current shell; use Personal Settings on desktop or the mobile drawer language code on narrow viewports. My Profile (/profile) is only for your name (and read-only email), not interface language.

Supported language options​

Pair with other Personal Settings sections

Missing translation keys fall back to English — see FAQ & Troubleshooting and Getting Started when operators report mixed-language screens after a locale switch. Full pairing matrix: Personal Settings section cross-reference.

The current implementation exposes these options:

Menu labelLanguage
EnglishEnglish
PortuguêsPortuguese
EspañolSpanish
ItalianoItalian

What changes when you switch language​

When you change the interface language, Vivin updates text that uses the platform translation system, including:

  • Top-level navigation labels and module labels
  • Module UI labels, buttons, tabs, and status text (where translations are provided)
  • Locale-aware date and currency formatting in screens that use Vivin locale formatters

The language preference is applied immediately in your session.

What may remain unchanged​

Some content is not translated by the selected interface language and may remain as-is:

  • Data entered by users (property names, notes, tenant names, free-text fields)
  • External source data and channel names
  • Any text in areas that do not yet have translation keys
  • Some screens that still use fixed formatting rules for dates or currency

If a translation is missing for a specific key, Vivin falls back to the default language behavior.

Preference scope and persistence​

  • The setting is saved per signed-in user (server-side preference when available, with browser storage as a fallback during migration — see product behaviour for your account).
  • Different users can keep different language preferences on the same workspace.
  • If no saved preference exists for a user, the interface defaults to English.

Personal Settings section cross-reference​

Use this table when one Personal Settings 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 changing locale or personal notification preferences.

| Personal Settings topic / section | Pair with these docs | | --------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | Personal Settings (interface language) | Users and roles (account_settings.personal) | | Your email preferences | Preferences — Notifications & Emails, Emails | | Your in-app notifications | Preferences — In-app notifications, Notifications module, Notifications — Payment overdue alerts, Handling a Late Payment — Step 1 | | Module tab order | My Profile, Deep Links | | Supported language options | FAQ & Troubleshooting, Getting Started | | 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 | Your in-app notifications, Users and roles — Role permissions (Approve payments), Finance — Pending manual payments | | Reject/revert mistaken receipts | Payment Allocation — Correcting mistaken receipts, Finance — Row actions on in-payment rows | | Notification row-click navigation | Personal Payments opt-out vs /notifications row-click | 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 when personal locale filters alerts | 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 after personal notification preferences | 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, Bookings — Other filters, Common Workflows — Portfolio segmentation | | Companion API guides | AI usage API (management JWT after lockout — UI locale independent of GET /ai-usage) |

Pair with other Interface Language 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: Personal Settings section cross-reference. Full hub matrix: Account Settings — Section cross-reference.

Documentation map & escalation​

Pair with other Interface Language guide sections

Documentation-map bullets pair with Introduction — Section cross-reference and FAQ — Section cross-reference. Hub parity: Account Settings hub — Documentation map & escalation. Full pairing matrix: Personal Settings section cross-reference · Account Settings — Section cross-reference.

  • Account Settings hub — Workspace-wide configuration vs personal locale preference
  • Getting Started — Shell overview (sidebar, Account, notifications)
  • FAQ & Troubleshooting — Operator answers that reference UI copy which may stay in English for some keys
  • My Profile — Name, email, and tab order on /profile (not where interface language lives)

Upstream & downstream workflows​

Pair with other Interface Language guide sections

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

Deeper workflow reads​

Pair with other Personal Settings guide sections

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

Pair with other Interface Language guide sections

Tab bullets pair with Account Settings — Tab cross-reference and Recommended setup order. Full pairing matrix: Personal Settings section cross-reference · Account Settings — Section cross-reference.

  • Preferences — Account Settings tab for booking defaults and notification masters (not interface language)
  • Preferences — In-app notifications — Account-wide master switches that gate categories before personal opt-out on this tab
  • Emails — Communication Rules whose operator copy may differ from UI locale
  • Users and roles — Grant account_settings.personal before teammates can open this tab

Operator modules​

Pair with other Interface Language guide sections

Module bullets pair with Modules — Module cross-reference. Full pairing matrix: Personal Settings section cross-reference · Account Settings — Section cross-reference.

Deeper concept reads​

Pair with other Interface Language guide sections

Concept reads pair with Concepts hub subsection index and Concept cross-reference. Full pairing matrix: Personal Settings section cross-reference · Account Settings — Section cross-reference.

Module documentation hubs​

Pair with other Interface Language guide sections

Module hub bullets pair with Modules — Module cross-reference. Full pairing matrix: Personal Settings section cross-reference · Account Settings — Section cross-reference.

  • Listings — Portfolio table column headers follow interface language
  • Tenants — List and profile column headers
  • Sales — Channel Manager and Multicalendar labels
  • Utilities — Bills Included ceiling model
  • Inbox — Portfolio-wide WhatsApp workspace
  • AI Chat — Vivin-internal AI Assistant
  • Audit — Portfolio-wide Manual Blocks and Discounts review
  • Booking engine details — Marketplace payload editor

Lockout catch-up after password recovery​

Pair with other Interface Language guide sections

Operational backlog after sign-in recovery pairs with Resetting a Management User Password — Step 3 before you resume locale or per-user notification opt-outs on /settings/personal. Hub parity: Common Workflows — Lockout catch-up after password recovery. Full pairing matrix: Personal Settings section cross-reference · Account Settings — Section cross-reference.

Pending manual receipt approval​

Pair with other Interface Language guide sections

Receipt approval pairs with Your in-app notifications payment alert opt-outs and Users and roles (Approve payments permission). Hub parity: Common Workflows — Pending manual receipt approval. Full pairing matrix: Personal Settings section cross-reference · Account Settings — Section cross-reference.

Reject/revert mistaken receipts​

Pair with other Interface Language guide sections

Receipt cleanup pairs with Payment Allocation two-layer receipts reached from notification deep-links in any interface language. Hub parity: Common Workflows — Reject/revert mistaken receipts. Full pairing matrix: Personal Settings section cross-reference · Account Settings — Section cross-reference.

Portfolio segmentation by tenant category​

Pair with other Interface Language guide sections

Segment filters pair with Tenant categories — interface language chips here do not translate tenant category filter labels in Bookings or Finance. Hub parity: Common Workflows — Portfolio segmentation by tenant category. Full pairing matrix: Personal Settings section cross-reference · Account Settings — Section cross-reference.

Notification row-click navigation​

Pair with other Interface language guide sections

Personal Payments opt-out on this tab may hide operator payment overdue rows — confirm teammates still see alerts before blaming missing /notifications rows. Hub parity: Account Settings — Notification row-click navigation. Full pairing matrix: Interface language section cross-reference · Account Settings — Section cross-reference.

Payment alert to receivables triage​

Pair with other Interface language guide sections

Locale changes do not clear payment overdue debt — row-click into Bookings and finish Handling a Late Payment — Step 1 after personal notification filters are saved. Hub parity: Account Settings — Payment alert to receivables triage. Full pairing matrix: Interface language section cross-reference · Account Settings — Section cross-reference.

Confirmation alert triage​

Pair with other Interface language guide sections

Personal locale does not approve confirmation receipts — Upcoming Payment received alerts still need Processing a New Booking — Step 5b on the opened booking. Hub parity: Account Settings — Confirmation alert triage. Full pairing matrix: Interface language section cross-reference · Account Settings — Section cross-reference.

Finance debt receivables triage​

Pair with other Personal Settings guide sections

Per-user email opt-outs do not suppress Total Debt KPIs — triage receivables on Finance → Overview when alerts were muted. Hub parity: Account Settings — Finance debt receivables triage. Full pairing matrix: Personal Settings section cross-reference · Account Settings — Section cross-reference.

Handling a Late Payment collections​

Pair with other Personal Settings guide sections

Per-user email opt-outs do not suppress Total Debt KPIs — triage receivables on Finance → Overview when alerts were muted Hub parity: Account Settings — Handling a Late Payment collections. Full pairing matrix: Personal Settings section cross-reference · Account Settings — Section cross-reference.

Finance Income status drill-down​

Pair with other Personal Settings guide sections

Locale changes do not alter Income chart segment labels — open drill-down modals on Finance → Overview for payment-line detail. Hub parity: Account Settings — Finance Income status drill-down. Full pairing matrix: Personal Settings section cross-reference · Account Settings — Section cross-reference.

Cash flow forecast drill-down​

Pair with other Personal Settings guide sections

Muted payment received emails still leave collections on Cash flow forecast — open month-bar drill-down after notification triage. Hub parity: Account Settings — Cash flow forecast drill-down. Full pairing matrix: Personal Settings section cross-reference · Account Settings — Section cross-reference.

Key glossary terms​

Pair with other Interface Language guide sections

Glossary rows pair with Glossary cluster cross-reference. Full pairing matrix: Personal Settings section cross-reference · Account Settings — Section cross-reference.

Companion API guides​

Pair with other Interface Language guide sections

API bullets pair with API Reference hub. Full pairing matrix: Personal Settings section cross-reference · Account Settings — Section cross-reference.