Productify

Appearance

Managing Tenants ​

Tenants are the top-level organizational units in Manager, representing separate customers or organizations in your SaaS platform.

What is a Tenant? ​

A tenant represents a customer or organization with:

  • Complete data isolation - Each tenant's data is separated
  • Independent configuration - Tenants can have unique settings
  • Multiple projects - Each tenant can have many projects
  • User access control - Manage who can access tenant resources

Creating a Tenant ​

Step 1: Navigate to Tenants ​

Click Tenants in the sidebar menu.

Step 2: Click Create ​

Click the Create Tenant button in the top-right corner.

Step 3: Fill in Details ​

Enter the tenant information:

  • Name (required) - Tenant display name
  • Identifier (optional) - Unique identifier (auto-generated if not provided)
  • Description (optional) - Brief description of the tenant

Step 4: Save ​

Click Create to save the new tenant.

Auto-generated Identifiers

If you don't provide an identifier, Manager will generate one automatically from the tenant name.

Viewing Tenants ​

The tenants page shows:

  • Name - Tenant display name
  • Identifier - Unique tenant ID
  • Projects - Number of projects
  • Applications - Number of applications
  • Created - Creation date
  • Actions - Edit, Delete, View

Filtering ​

Use the search box to filter tenants:

Search by name or identifier

Sorting ​

Click column headers to sort:

  • Name (A-Z or Z-A)
  • Created (newest or oldest)
  • Projects (count)

Editing a Tenant ​

Option 1: From List ​

  1. Find the tenant in the list
  2. Click the Edit icon
  3. Update the information
  4. Click Save

Option 2: From Detail Page ​

  1. Click the tenant name to open details
  2. Click Edit button
  3. Modify fields
  4. Click Save Changes

Tenant Details ​

Click a tenant name to view:

Overview Tab ​

  • Tenant information
  • Statistics (projects, applications, users)
  • Recent activity

Projects Tab ​

List of all projects in this tenant:

  • Project names
  • Application counts
  • Creation dates
  • Quick actions

Applications Tab ​

All applications across all projects:

  • Application names
  • Associated projects
  • Endpoints
  • Status

Settings Tab ​

Tenant-level configuration:

  • Backend settings
  • Frontend settings
  • Default values for projects

Users Tab ​

User access management:

  • Users with access to this tenant
  • Role assignments
  • Add/remove users

Deleting a Tenant ​

Warning

Deleting a tenant will permanently remove all associated projects, applications, and data. This cannot be undone.

Steps to Delete ​

  1. Navigate to tenant details
  2. Click Delete button
  3. Confirm by typing the tenant name
  4. Click Confirm Delete

What Gets Deleted ​

  • The tenant record
  • All projects in the tenant
  • All applications in projects
  • All settings and configurations
  • All user associations
  • All audit logs related to the tenant

Best Practices ​

Naming ​

  • Use clear, descriptive names
  • Include customer or organization name
  • Avoid special characters in identifiers

Organization ​

  • Create one tenant per customer/organization
  • Use projects to organize applications within a tenant
  • Set tenant-level defaults for common settings

Access Control ​

  • Assign users to tenants based on need
  • Use roles to control permissions
  • Regularly review user access

Monitoring ​

  • Check tenant activity in audit logs
  • Monitor application health per tenant
  • Track resource usage

Common Tasks ​

Migrate Data Between Tenants ​

Data cannot be automatically migrated. To move data:

  1. Export settings from source tenant
  2. Create applications in destination tenant
  3. Import settings
  4. Update endpoints and DNS

Clone Tenant Configuration ​

  1. View source tenant settings
  2. Copy settings (JSON editor mode)
  3. Create new tenant
  4. Paste settings in new tenant

Bulk User Assignment ​

  1. Navigate to tenant users
  2. Click Add Users
  3. Select multiple users
  4. Assign roles
  5. Click Save

Troubleshooting ​

Cannot Delete Tenant ​

Reason: Tenant has active applications

Solution: Delete all applications first, then delete tenant

Settings Not Applying ​

Reason: Application-level settings override tenant settings

Solution: Check configuration inheritance in settings editor

User Cannot Access Tenant ​

Reason: User not assigned to tenant

Solution: Add user in tenant's Users tab with appropriate role

See Also ​