> ## Documentation Index
> Fetch the complete documentation index at: https://help.propops.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Multi-Tenancy Setup

> Configure organisations, isolate data, apply custom branding, and manage feature flags per tenant.

This guide covers setting up and managing multiple organisations in PropOps.

***

## Creating an organisation

<Steps>
  <Step title="Open organisation settings">
    Go to **Admin → Organisations** (SysOps access required).
  </Step>

  <Step title="Add a new organisation">
    Click **Add Organisation** and fill in:

    * **Name** — the organisation's display name
    * **Domain** — the organisation's primary domain (optional)
    * **Contact email** — main admin contact
  </Step>

  <Step title="Save">
    Click **Create**. The organisation is now active and ready for users and configuration.
  </Step>
</Steps>

***

## Assigning users to an organisation

<Steps>
  <Step title="Open the user account">
    Navigate to **Admin → Users** and select the user.
  </Step>

  <Step title="Set the organisation">
    In the user's profile, select the target **organisation** from the dropdown.
  </Step>

  <Step title="Save">
    The user now belongs to that organisation and can only see its data.
  </Step>
</Steps>

<Warning>
  Changing a user's organisation immediately changes what data they can access. Double-check before reassigning — particularly for users with admin-level roles.
</Warning>

***

## Applying custom branding

<Steps>
  <Step title="Open branding settings">
    Go to the organisation's **Settings → Branding**.
  </Step>

  <Step title="Upload a logo">
    Upload the organisation's logo. It will appear in the sidebar and on the login page.
  </Step>

  <Step title="Set brand colours">
    Choose a **primary colour** and optionally secondary and accent colours. The entire UI adapts to match — buttons, headers, links, and status indicators.

    <Info>
      Text colour is calculated automatically to ensure readability against your chosen background colours. You don't need to set text colours manually.
    </Info>
  </Step>

  <Step title="Preview and save">
    Preview the changes in the branding panel, then click **Save**. Changes take effect immediately for all users in the organisation.
  </Step>
</Steps>

***

## Managing feature flags

Feature flags let you enable or disable specific platform features per organisation:

<Steps>
  <Step title="Open feature flags">
    Go to the organisation's **Settings → Feature Flags**.
  </Step>

  <Step title="Toggle features">
    Enable or disable features as needed. Common flags include:

    * WhatsApp messaging
    * Advanced reporting
    * Contractor coverage map
    * Financial module
    * Tenant management
  </Step>

  <Step title="Save">
    Changes take effect immediately. Disabled features are hidden from the navigation and inaccessible via the API for users in that organisation.
  </Step>
</Steps>

***

## Data isolation verification

To confirm data isolation is working correctly:

1. Log in as a user in **Organisation A**
2. Note the jobs, users, and records visible
3. Log in as a user in **Organisation B**
4. Confirm that none of Organisation A's data is visible

<Tip>
  Use the **test data generator** (Admin → Test Data) to seed sample data for a new organisation without affecting production data in other organisations.
</Tip>