---
title: "Multi-Tenant Hierarchy | Platform Reference | Ilmiya Documentation"
description: "The Organization is Ilmiya's tenant boundary — its domains, Spaces, roles, settings, Router resolution, and audit logging."
url: "https://ilmiya.com/docs/platform/multi-tenant-hierarchy/"
language: "en"
---

<a id="_top"></a>

# Multi-Tenant Hierarchy

The **Organization** is Ilmiya’s tenant boundary: each customer institution runs in its own Organization with its own subdomain, login page, user base, and data, isolated from every other tenant.

<a id="what-it-does"></a>

## What it does

Every Organization receives a default domain of the form `org-slug.myilmiya.com`, assigned by Ilmiya (for example, `bahaji.myilmiya.com`).

The **Router** at `myilmiya.com` is the tenant-resolution entry point: a user types their school or organization name, the Router validates in real time that it exists (a green checkmark confirms a match), and on **Next** redirects to that organization’s login page at `org-slug.myilmiya.com/login`.

After login, role determines the landing portal — students land in Campus, parents and guardians in Portal.

Inside the tenant, Ilmiya documents five organizational functions:

-   **Home** (the dashboard, a real-time overview of activities, goals, and progress)
-   **People** (roles, hierarchies, and responsibilities)
-   **Engage** (internal and external communication channels)
-   **Analytics** (performance measurement)
-   **Admin** (policies, security, and high-level control)

The tenant’s population covers Staff, Students, Guardians, and Families, managed through the People portal — Ilmiya’s Student Information System module.

Staff hold one of three roles:

-   **Admin** (full system control including staff management and settings)
-   **Staff** (operational access)
-   **Member** (limited access for specialized or support roles).

Below the Organization, **Spaces** are the grouping unit: virtual classrooms or groups used to organize students, subjects, and teams.

-   The **Roster** is the administrator dashboard for viewing and managing users across organizations or spaces, including last-login tracking.
-   **Labels** are colour-coded tags applied to students, tasks, and spaces for categorization and filtering. **Logs** record every user action in the tenant for audit.

<a id="key-objects"></a>

## Key objects

| Object | Definition |
| --- | --- |
| Organization | The customer tenant; owns a default `org-slug.myilmiya.com` domain |
| Tenant ID | Unique identifier for the organization; cannot be changed |
| Tenant Region | Country of registration; used for compliance and localization |
| Space | Virtual classroom or group under the organization |
| Roster | Dashboard of users across organizations or spaces, with last-login data |
| Label | Colour-coded tag for students, tasks, and spaces |
| Staff role | Admin (full control), Staff (operational), or Member (limited) |
| Log entry | Audit record: user, resource, action, timestamp, and IP address |

<a id="configuration"></a>

## Configuration

Organization-level settings live in Admin Panel → Settings.

-   **Org Info** holds the Organization Name used for identification across the platform.
-   **Tenant Info** holds the Tenant ID (read-only), the Tenant Domain (may be adjustable), and the Tenant Region.
-   Domains: the default domain is assigned automatically; one or multiple custom domains can be added and verified through DNS TXT records — see [Integrations](https://ilmiya.com/docs/platform/integrations/) for the flow.
-   Staff: new members are invited by email from the Staff panel; profiles support role changes, detail updates, workspace reassignment, and removal.
-   Spaces: created with a name and icon; each space’s actions menu offers Edit and Delete.
-   Logs: searchable and filterable by user, resource, action, and timestamp; downloadable as PDF for audits.

<a id="constraints-and-edge-cases"></a>

## Constraints and edge cases

-   The Tenant ID cannot be changed.
-   The Router rejects **Next** without a validated organization; users who already know their direct URL can skip the Router entirely and bookmark `org-slug.myilmiya.com`.
-   Staff removal is permanent and Admin-only; transfer data and responsibilities first. Some configurations allow suspension instead of full deletion.
-   Space deletion is permanent and may impact linked tasks or workflows; only admins or space owners can delete. Archive disables a space without losing its data.
-   Custom-domain DNS propagation can take up to 48 hours, though it typically resolves within minutes to a few hours.
-   Logs capture every action — account creation, modification, logins — with timestamp, IP address, and live location details.

<a id="works-with"></a>

## Works with

-   [Integrations](https://ilmiya.com/docs/platform/integrations/) — DNS TXT verification for custom domains; bulk CSV import for populating the tenant.
-   [AI capabilities](https://ilmiya.com/docs/platform/ai-capabilities/) — Aide, Aide\_Live, Aide\_Chat\_Speaker, and Canvas\_Recite are enabled per Organization.
-   [Analytics](https://ilmiya.com/docs/platform/analytics/) — measurement and leaderboard ranks are scoped to the tenant.
-   Portal documentation: [Router](https://ilmiya.com/docs/router/), [Finding your school](https://ilmiya.com/docs/router/finding-your-school/), [Settings](https://ilmiya.com/docs/administration/settings/), [Domains](https://ilmiya.com/docs/administration/domains/), [Staff](https://ilmiya.com/docs/administration/staff/), [Spaces](https://ilmiya.com/docs/administration/spaces/), [Roster](https://ilmiya.com/docs/administration/roster/), [Labels](https://ilmiya.com/docs/administration/labels/), [Logs](https://ilmiya.com/docs/administration/logs/), [People](https://ilmiya.com/docs/people/), [Organizations](https://ilmiya.com/docs/foundations/organizations/).

[Previous  
Analytics](https://ilmiya.com/docs/platform/analytics/) [Next  
Integrations](https://ilmiya.com/docs/platform/integrations/)

---

[View this page on Ilmiya](https://ilmiya.com/docs/platform/multi-tenant-hierarchy/) · [All pages in Markdown](https://ilmiya.com/markdown-index.md)