Managing Tenants

Purpose {#purpose}

As a platform administrator, you create new organizations (tenants) and manage their master data.

Navigation: /platform/tenants or /platform

Tenant List {#tenant-list}

/platform/tenants shows all organizations with:

• Name and subdomain
• Status (active, inactive, …)
• Creation date
• Quick actions

Create a New Tenant {#create-a-new-tenant}

1. Create tenant on /platform/tenants
2. Required fields:
   • Name — company display name
   • Subdomain — e.g. acme → acme.evisys.app
   • Time zone — e.g. Europe/Berlin
3. Optional: load demo data
4. Save

After creation, the tenant is reachable at its subdomain.

Status Effects {#status-effects}

Changes take effect immediately. Setting status to Trial (or extending) starts/renews the 14-day window. Demos use the same timer.

Demo Tenant {#demo-tenant}

Use the Demo tab on /platform/tenants to create a showcase tenant:

• Starts in Trial status with the 14-day timer
• Rich sample data (inventory, orders, crew, stocktakes, finance, …)
• Notifications suppressed
• Extend (+14 days) from the tenant detail page

Tenant Detail {#tenant-detail}

/platform/organizations/:id — overview with:

• Master data summary
• User count
• Status and demo expiry
• Links to edit, users, roles, data

Edit Tenants {#edit-tenants}

Master Data (Platform) {#master-data-platform}

/platform/organizations/:id/stammdaten

Platform-side editing of name, subdomain, status, time zone — similar to tenant master data, but with platform permission.

Danger Zone {#danger-zone}

/platform/organizations/:id/danger

Critical actions (e.g. deactivate or delete tenant) — only with deliberate confirmation.

Warning: Deletion is irreversible and affects all tenant data.

Subdomain Rules {#subdomain-rules}

• Subdomains must be unique
• Lowercase letters, numbers, hyphens only
• Reserved names (e.g. www, platform) are blocked

Common Issues {#common-issues}

Last updated: July 2026