🏛️Tenant Self-Registration (frontend)
The Tenant Registration feature enables public users (e.g., customers or businesses) to self-register and create a new tenant account in your SaaS platform. This behaviour can be globally controlled from the General Settings panel, giving you the flexibility to allow or restrict access as needed.
⚙️ Controlling Tenant Registration via General Settings
To configure tenant registration:
Go to Settings → Saas Settings.
Find the option labeled “Tenant Registration”.
Toggle the setting:
✅ Enabled: Public users can access the registration form and create tenants.
❌ Disabled: Registration is restricted to admin users only.
🔐 This control allows you to manage the flow of new tenant signups — perfect for soft launches, internal testing, or controlled access.
📝 Tenant Registration Form (Frontend)
When enabled, the registration form becomes publicly available on your frontend (via /tenant/register route).
📄 Form Fields Include:
Tenant/Company Details (Company Name, Street Address, City, State/Region, Postal Code, Country)
User Details (Name, Email)
Domain or Subdomain (if required by your setup)
Package Selection
🔒 The form is protected with validation for fields such as unique email, domain availability tec.
🗃️ Database Scheme Behavior for Registered Tenants
⚠️ Important Note: Tenants registered through the public registration form will use the currently active database and share the same tables (i.e., Use the current active database as their DB Scheme).
This setup ensures lightweight provisioning and is optimal for shared-database multi-tenant configurations.
If you require isolated databases or alternative schemes, this must be handled through the admin panel during manual tenant creation or updating tenant details from the admin panel after tenant creation.
🚫 When Registration is Disabled
If “Allow Public Tenant Registration” is turned off:
The registration page becomes inaccessible.
Visitors attempting to access the form will receive a 404 Error Page.
Only admins can create new tenants from Saas → Tenants → Create Tenant.
Last updated