NerveDocs

Getting Started

Workspaces, organisations and properties

How an organisation, a property and your active context relate — and what changes when you switch between them mid-shift.

Last updated

Who this is for: everyone — no permission is required to switch between contexts you already have access to. Where: the picker after sign-in, and the property switcher at the top of the sidebar

Nerve has two levels of tenancy:

  • An organisation is the company. It owns the members, the roles and the properties.
  • A property — a hotel — is the thing you operate. Rooms, guests, reservations and folios all belong to one.

Your active context is which pair you are currently working in. Almost everything on screen is scoped to it, and it is named in the sidebar header and on the Dashboard under Active scope.

Choose where to work#

An account reaching more than one organisation or property lands on the picker after sign-in.

  1. Find the organisation. Each is listed with how many properties it holds and which realm it belongs to.
  2. Select a property card. Each shows the property's time zone and the apps enabled on it.
  3. You land on the Dashboard in that context.

An account reaching exactly one organisation with exactly one property never sees this: it resolves straight through.

The picker may also show two entries that are not properties:

  • Manage organisation on an organisation you can administer — it enters that organisation at org level, with no property selected.
  • Partner portal, for an account that is also an affiliate partner. Crossing into it asks for your password again. That is a realm boundary, not a bug — see realms.

An organisation with no properties yet offers an Organisation workspace instead of property cards.

Switch property mid-shift#

  1. Select the property switcher at the top of the sidebar.
  2. Choose an organisation and property from the list. The one you are in is ticked.
  3. Or select View all properties… to go back to the full picker.

Switching takes effect immediately and without a full page reload.

Know what switching invalidates#

Changing context re-resolves everything that depends on it:

  • Your navigation is rebuilt. A different role or a different set of enabled apps means a different sidebar. Menu items appearing or disappearing across a switch is the system working.
  • Every list re-fetches. Reservations, the rack, folios — the previous property's rows are gone, replaced by this one's or by an empty state. Nothing bleeds across.
  • Your permissions are re-resolved. You may be a Manager in one organisation and read-only in another; the actions offered change to match.

Important

An empty screen straight after a switch usually means the new property genuinely has no data of that kind — not that the switch failed. Check the sidebar header names the property you expected before going looking for a bug.

A bookmarked or pasted URL — a rack, a folio, an arrivals list — resolves its context before it renders anything. You see a short loading state, then the page, for the right property. There is never a flash of another organisation's data or of an unauthorized screen on the way.

The same holds after a hard refresh, and after signing in from a deep link: you are taken to the page you asked for, not dropped at the top.

Note

If your access to the remembered property has been removed, the app says so and offers Back to properties rather than half-loading. That state is deliberately non-revealing — it does not say whether the property still exists.

What's next#