Super Admin Guide

This guide covers how to access and use the super admin panel to manage resellers, tenants, and system-wide settings.

Accessing the Super Admin Panel

Create a Super Admin Account:

   php artisan user:create-super-admin your-email@example.com "Your Name" "your-password"

Or set an existing user as super admin:

   php artisan user:set-super-admin your-email@example.com

Log In:

Navigate to: https://dashboard.swellsystem.com/admin
Log in with your super admin credentials
You'll have access to the Filament admin panel

Managing Resellers

Creating a Reseller

Navigate to Resellers in the admin panel sidebar
Click Create Reseller
Fill in the required fields:

User: Select an existing user or create one first
Company Name: The reseller's company name
Slug: A unique identifier (URL-friendly)
Total Licenses: Number of licenses allocated
Is Active: Toggle to activate/deactivate the reseller

Click Create

Managing Reseller Licenses

View License Usage: See total licenses, used licenses, and available licenses in the Resellers table
Update Licenses: Edit a reseller to increase their license count
Monitor Usage: Track how many tenants each reseller has created

Reseller Fields Explained

User ID: Links the reseller account to a user account (required)
Company Name: Display name for the reseller
Slug: Unique identifier used in URLs (must be unique)
License Count: Total number of licenses purchased/allocated
License Used: Number of licenses currently in use (auto-calculated)
Available Licenses: Licenses remaining (calculated: license_count - license_used)
Is Active: Whether the reseller account is active
Branding Config: JSON configuration for white-labeling (optional)

Managing Tenants

Viewing All Tenants

Navigate to Tenants in the admin panel to see:

All tenant accounts in the system
Which reseller created each tenant
Tenant status (active/inactive)
Subscription information
User counts

Creating Tenants

Tenants are typically created by resellers through their accounts. However, super admins can:

Navigate to Tenants → Create Tenant
Fill in tenant details:

Name
Subdomain
Reseller (if applicable)
Active status
Trial end date
Subscription end date

Click Create

Impersonating Tenants

Super admins can impersonate tenants for support purposes:

Go to Tenants in the admin panel
Find the tenant you want to impersonate
Click on the tenant to view details
Use the impersonate feature (if available in your implementation)

Note: Impersonation allows you to see the tenant's view exactly as they see it, which is helpful for troubleshooting.

Managing Users

Viewing All Users

Navigate to Users in the admin panel to see:

All user accounts across all tenants
Super admin status
Current tenant
Associated tenants count
Reseller account status

Setting Super Admin Status

Go to Users
Find the user you want to promote
Click Edit
Check the Is Super Admin checkbox
Save

Security Note: Only super admins can grant super admin status to other users.

Best Practices

Security

Limit Super Admin Accounts: Only grant super admin status to trusted administrators
Use Strong Passwords: Ensure all super admin accounts use strong, unique passwords
Monitor Activity: Regularly review tenant and reseller activity
Audit Logs: Keep track of administrative actions (implement logging if not already present)

License Management

Verify Before Allocating: Ensure resellers have purchased licenses before allocating them
Monitor Usage: Regularly check license usage to prevent over-allocation
Plan Ahead: Anticipate reseller license needs and ensure adequate allocation

Support Workflows

Use Impersonation: Use the impersonation feature to troubleshoot tenant issues
Document Actions: Keep notes on administrative actions for reference
Communicate Changes: Notify resellers and tenants when making significant changes

Troubleshooting

Can't Access Admin Panel

Verify your account has is_super_admin = true
Check that you're accessing /admin (not /login)
Ensure your session hasn't expired

Reseller Can't Create Tenants

Check reseller's license count vs. license used
Verify reseller account is active
Check that the user account is properly linked

Tenant Issues

Review tenant status (active/inactive)
Check subscription and trial dates
Verify tenant has necessary modules activated
Check for any error logs in the tenant's context

Additional Resources

Updated on: 13/03/2026

Was this article helpful?

Thank you!