Super Admin Features
Super Admin is the highest privilege level in Levy Fleets, providing complete access to manage all subaccounts, configure system-wide settings, and access administrative tools not available to regular users. This comprehensive guide covers all exclusive Super Admin capabilities.
Who is a Super Admin?
Super Admin status is determined by the user's role in the database:
| Role | Super Admin Access |
|---|---|
super_admin | Yes - Full access |
global_admin | Yes - Equivalent access |
admin | No - Limited to assigned subaccount |
fleet_manager | No - Limited to assigned subaccount |
| Other roles | No |
Demo Account
The demo account (demo@levyelectric.com) automatically receives Super Admin access for demonstration purposes.
Accessing Super Admin Features
Super Admin-only features are visually distinguished in the navigation:
- Purple gradient buttons
- "Super admin only" labels
- Visible only when logged in as super_admin or global_admin
Admin Navigation
In the Admin section sidebar, Super Admins see additional menu items:
- Master Subaccounts (purple button with "Super admin only" label)
- Email Settings
- Database Tools
Master Subaccounts Management
The centerpiece of Super Admin functionality. Access via Admin > Master Subaccounts.
Dashboard Overview
The Master Subaccounts page displays comprehensive metrics and management tools:
Header Metrics Cards
| Metric | Description |
|---|---|
| Total Subaccounts | Count of all subaccounts in the system |
| Active Subaccounts | Subaccounts with "Active" status |
| Total Vehicles | Aggregate vehicles across all subaccounts |
| Active Vehicles | Vehicles currently operational |
| Current Month Revenue | Total revenue this month |
| Partner Share | Estimated payout to partners |
| Revenue Change % | Comparison to previous month |
| Avg Revenue/Subaccount | Average revenue per active subaccount |
Filtering and Searching
Search Box: Find subaccounts by:
- Name
- City
- State
- Contact email
- Primary contact name
- Legal entity name
Status Filter: Filter by fleet status:
- All Status
- Active
- Paused
- Suspended
- Draft
Fleet Type Filter: Filter by fleet type (dynamic list based on existing data)
Subaccount List
Each subaccount card displays:
- Name: Subaccount display name
- Type: Fleet type classification
- Status: Current operational status
- Location: City and state
- Vehicles: Total and active count
- Revenue: Current month revenue
- Health indicators: Banking info status, agreement status
Creating and Managing Subaccounts
Creating a New Subaccount
Click New Subaccount
Click the "+ New Subaccount" button at the top of the Master Subaccounts page.
Fill in Basic Information
Complete the Quick Create modal:
- Subaccount Name (required)
- Legal Entity Name (optional)
- Fleet Type (optional)
- Status (default: Draft)
Save and Configure
Click Create to save. The new subaccount opens in the detail drawer for further configuration.
Draft Status
Use "Draft" status for new subaccounts still being configured. This prevents them from appearing in production contexts.
Duplicating a Subaccount
To quickly create a new subaccount based on an existing one:
- Click the duplicate icon on any subaccount card
- A new subaccount is created with:
- "(Copy)" appended to name
- Same basic configuration
- New unique identifier
- Edit the duplicate to customize
Editing Subaccount Details
Click a subaccount card to open the detail drawer with comprehensive tabs:
Identity Tab
| Field | Description |
|---|---|
| Subaccount Name | Display name in the system |
| Legal Entity Name | Official business name for contracts |
| Fleet Status | Active, Paused, Suspended, or Draft |
| Fleet Type | Classification of the fleet |
| Partner Share % | Commission percentage for the partner |
Contact Tab
| Field | Description |
|---|---|
| Primary Contact | Main contact person name |
| Contact email address | |
| Phone | Contact phone number |
Location Tab
| Field | Description |
|---|---|
| Address Search | Google Maps autocomplete |
| Street Address | Street address line |
| Full Address/Notes | Additional address details |
| City | City name |
| State/Province | State or province |
| Postal Code | ZIP or postal code |
| Country | Country name |
| Local Review URL | Link to local review page |
Online Presence Tab
| Field | Description |
|---|---|
| Website Landing Page | Partner's custom landing page URL |
| Registration Link | Direct customer registration link |
These URLs help direct customers to the correct subaccount during signup.
Branding Tab
| Field | Description |
|---|---|
| Location Image | Upload PNG/JPEG/WEBP (max 8MB) |
| Agreement PDF | Upload service agreement document |
Agreements Tab
Levy Service Agreement Management:
- Preview Agreement: View generated agreement
- Download DOCX: Editable Word document
- Download PDF: Printable PDF version
- Generate & Save: Store agreement in system
Agreement uses template variables:
- Partner name and entity name
- Partner share percentage
- Setup fee per vehicle
- Minimum retainer per vehicle
Financials Tab
| Field | Description |
|---|---|
| Setup Fee/Vehicle | One-time fee per vehicle added |
| Min Retainer/Vehicle | Minimum monthly fee per vehicle |
| Sales Tax Rate % | Applicable sales tax |
| Stripe Fee % | Payment processing fee |
| Sales Tax Filing Cadence | Monthly, Quarterly, Annual |
| Filing Frequency | Detailed filing schedule |
| Sales Tax Summary | Tax overview notes |
| Exclusive Territories | Protected geographic areas |
| Sales Tax Credentials | Tax authority credentials |
| e-File Status | Electronic filing status |
Banking Tab
| Field | Description |
|---|---|
| Account Holder Name | Name on bank account |
| Account Number | Bank account number |
| Routing Number | Bank routing number |
| Swift/BIC Code | International transfer code |
Banking Health
A warning indicator appears if banking information is incomplete. Complete banking details are required before partner payouts can be processed.
Partner Setup Form Links
Generate shareable links for partners to submit their own banking and tax information:
Open Partner Setup Section
Click "Partner Setup Form" section in subaccount drawer
Generate or View Link
Click "Generate New Link" (or view existing)
Share with Partner
Copy the link to share with partner
Partner Completes Form
Partner fills out form without needing login
Check Submission Status
Submission status shows: "Pending" or "Submitted"
Link Behavior:
- Links are single-use by default
- Regenerating invalidates previous link immediately
- Links expire after a configurable period
Email Settings
Access via Admin > Email Settings.
Configuration Overview
View SMTP configuration status and test email functionality:
- SMTP Host: Email server hostname
- SMTP Port: Server port
- Sender Email: From address for outgoing emails
- Environment Status: Shows which env vars are configured
Test Email
Send a test email to verify configuration:
- Enter recipient email address
- Click "Send Test Email"
- Check inbox for test message
Notification Types
Configure which notifications are sent:
| Notification | Description |
|---|---|
| Vehicle Error Alerts | IoT device errors |
| Identity Verification Failed | Stripe identity failures |
| Customer Account Blocked | Account suspension notifications |
Direct Subaccount Communication
Super Admins can send emails directly to subaccount contacts:
- From Master Subaccounts, select a subaccount
- Click "Send Email" button
- Compose message with subject and body
- Email sends to the subaccount's contact email
Email Properties:
- Subject: "Message from Levy Fleets Admin"
- Reply-to: Configured admin email
- Bypasses email notification preferences
Database Tools Access
Super Admins have full access to:
- Import Statistics: View total counts across all tables
- Customer Import: Bulk import customer CSV files
- Rides Import: Bulk import ride history CSV files
- Stripe Import: Sync payment data from Stripe
For detailed information on import tools, see Data Import Tools.
Global View Capability
Super Admins can access a special "Global" view:
- In the subaccount dropdown (header), select "Global"
- View aggregated data across all subaccounts
- Available in analytics and reporting sections
Global View Limitations
Not all features support Global view. Some require a specific subaccount selection.
Permission Differences
Super Admin vs. Admin
| Capability | Super Admin | Admin |
|---|---|---|
| View all subaccounts | Yes | No (own only) |
| Create subaccounts | Yes | No |
| Manage subaccount settings | Yes (all) | Yes (own only) |
| Access Master Subaccounts | Yes | No |
| Email Settings | Yes | No |
| Demo Links | Yes | No |
| Generate agreements | Yes | No |
| Manage banking info | Yes | Limited |
| Global view | Yes | No |
Super Admin vs. Fleet Manager
| Capability | Super Admin | Fleet Manager |
|---|---|---|
| Team management | Yes | No |
| Settings access | Full | View only |
| Import tools | Yes | No |
| Customer management | Full | Limited |
| Analytics | All subaccounts | Own subaccount |
Security Considerations
Best Practices
- Limit Super Admin accounts: Only essential personnel
- Use strong passwords: Enforce password complexity
- Enable 2FA: When available
- Audit regularly: Review Super Admin actions
- Document changes: Keep records of major configuration changes
Access Auditing
Super Admin actions are logged:
- Subaccount creation and modification
- Agreement generation
- Link generation
- Email communications
- Manual verifications
Troubleshooting
Can't Access Super Admin Features
Possible Causes:
- Role not set to
super_adminorglobal_admin - Session expired
- Permissions not synced
Solutions:
- Verify role in user settings
- Log out and log back in
- Contact system administrator
Subaccount Changes Not Saving
Possible Causes:
- Required fields missing
- Validation errors
- Database connection issues
Solutions:
- Check for error messages
- Verify all required fields are filled
- Retry the operation
Partner Setup Link Not Working
Possible Causes:
- Link was regenerated (previous invalidated)
- Link expired
- Link already submitted
Solutions:
- Generate a new link
- Check link status in the interface
- Verify link hasn't been used
What's Next?
- Data Import Tools - Learn about bulk data importing
- Stripe Data Sync - Configure payment data synchronization
- Demo Links - Manage demonstration access links
- Understanding Subaccounts - Deep dive into subaccount architecture
Super Admin Ready
With Super Admin access, you have complete control over your Levy Fleets platform. Use these tools responsibly and always follow security best practices when managing sensitive data.