Skip to main content

Tenants, Companies & Users

A tenant is a distinct organizational boundary in Illumera. Every person profile, company, project, engagement, and match score is strictly scoped to a tenant. Companies are the employer organizations that live inside tenants, and users are the individual accounts — each holding one or more RBAC roles. This guide walks through the day-to-day tasks for governing all three.

Browse and manage tenants​

The tenant list shows every organization on the platform with its plan, status, and a per-row action menu.

  1. Navigate to Admin → Tenants.
  2. Use the search box to filter tenants by name.
  3. Click the ⋮ (more) menu on any row to open its actions: View detail, Suspend or Reactivate, Edit, or Impersonate.
Suspension is a record-keeping signal

Suspending a tenant sets its status to suspended in the database. The current auth middleware does not hard-block API access on tenant status, so treat suspension as an operational signal rather than an enforced sign-in lock.

Impersonation is audited

Choosing Impersonate starts a session in the context of the tenant's admin and writes an entry to the audit trail. Use it only for support and debugging.

📷 ScreenshotThe tenant directory with per-row action menu/admin/tenants

Create a new tenant​

  1. From Admin → Tenants, click New Tenant (the + button).
  2. Enter the Organization name. A URL slug is generated automatically — edit it if you need a custom value.
  3. Choose a Plan (Starter, Pro, or Enterprise) and an initial Status (Trial, Active, or Suspended).
  4. Optionally set an Email domain, used for email-domain matching within the tenant.
  5. Click Create. You are returned to the tenant list with the new tenant added.
note

No invitation email is sent automatically. Users must sign up and complete onboarding independently, or you can pre-register them from the user directory.

📷 ScreenshotThe new-tenant form/admin/tenants/new

Open tenant detail​

The detail page shows the tenant's plan, status, MRR, domain, and creation date, along with its member roster.

  1. From the tenant list, choose View from the row menu (or open /admin/tenants/:id).
  2. Review the tenant metadata cards at the top.
  3. In the Members section you can:
    • Add a member — search the user directory and attach an existing user with a member role.
    • Remove a member — detach a user from the tenant.
  4. Use the back link to return to the tenant list.
📷 ScreenshotTenant detail with the member roster/admin/tenants/:id

Browse companies​

The companies directory lists every employer organization across all tenants.

  1. Navigate to Admin → Companies.
  2. Search by name, or click Filters to narrow by country, industry, company size, or verification status (identity, payment, both, or none).
  3. Click any sortable column header (name, industry, country, city, size, verified) to sort.
📷 ScreenshotThe companies directory with filters and sortable columns/admin/companies

Manage users and roles​

The user directory is the platform-wide account list, spanning every tenant.

  1. Navigate to Admin → Users.
  2. Search by name or email, and filter by tenant, role, or status (active, inactive, archived). Results are paginated.
  3. Open a user to view their profile, tenant membership, and roles.
  4. To change roles, edit the role set and save. Changes take effect on the user's next API request.
Role changes are not audited

Editing a user's roles updates the database immediately but does not currently write an audit log entry.

The header also surfaces directory stats: total users, total admins, and total company users.

📷 ScreenshotThe platform-wide user directory with role editing/admin/users

Pre-register a user​

  1. From Admin → Users, click New User.
  2. Enter the user's Email and Display name.
  3. Select one or more roles (Talent, Company, or Platform Admin).
  4. Optionally assign a tenant.
  5. Click Create to add the account to the directory.
Grant platform_admin with care

The Platform Admin role confers full, unrestricted access to every tenant and all platform settings. Assign it only to trusted operators.

📷 ScreenshotThe new-user form with role and tenant assignment/admin/users/new