Overview
The User Management interface allows administrators to view, edit, and manage all users in your SnailyCAD instance. You can control user permissions, assign roles, manage whitelist status, and perform administrative actions.Accessing User Management
Navigate to Admin > Manage > Users to access the user management interface.Required Permissions
To access user management, you need one of the following permissions:ViewUsers- View user listManageUsers- Edit user details and permissionsBanUsers- Ban/unban usersDeleteUsers- Delete user accounts
User List Views
The user management page has two tabs:All Users Tab
Displays all registered users in your CAD with the following information:- Username - User’s login name
- Rank - User rank (Owner, Admin, or User)
- Admin Permissions - Whether user has admin access
- LEO Permissions - Whether user has law enforcement access
- EMS/FD Permissions - Whether user has emergency medical services access
- Dispatch Permissions - Whether user has dispatch access
- Whitelist Status - (If CAD is whitelisted) Acceptance status
- Search - Search by username, user ID, Steam ID, or Discord ID
- Sorting - Sort by username, rank, or whitelist status
- Pagination - Navigate through large user lists (35 users per page)
Pending Users Tab
Shows users awaiting whitelist approval. Only visible when your CAD has whitelisting enabled.Editing Users
Click Manage next to a user to access their detailed settings.Basic Information
Edit the following user details:- Username - User’s login name
- Steam ID - Optional Steam account identifier
- Discord ID - Optional Discord account identifier
Managing Permissions
Click Manage Permissions to assign individual permissions to a user. SnailyCAD uses a detailed permission system with granular control over features: Admin Permissions:ViewUsers,ManageUsers,BanUsers,DeleteUsersViewCustomFields,ManageCustomFieldsViewCustomRoles,ManageCustomRolesManageCadSettingsViewAuditLogs
Leo- Access law enforcement featuresViewIncidents,ManageIncidentsManageRecordsManagePenalCodes
Dispatch- Access dispatch interfaceManageActiveUnitsManageTowCalls
EmsFd- Access emergency medical services
Owner rank users have all permissions by default and cannot be edited.
Managing Roles
Click Manage Roles to assign custom roles to a user. Custom roles are predefined permission sets that can be applied to multiple users. See Custom Roles for more information.API Token Area
For users with API tokens:- View API token usage logs (last 35 requests)
- Revoke API Token - Remove user’s API access
Two-Factor Authentication
Administrators can disable 2FA for users who have lost access:- Click Disable 2FA in the user’s management page
- This action is logged in the audit logs
User Actions
Temporary Password
Generate a temporary password for users who forgot their credentials:- Navigate to the user’s management page
- Click Give Temp Password
- Copy the generated password and share it securely with the user
- User must change the password on next login
Banning Users
Ban users to prevent them from accessing the CAD:- Navigate to the user’s management page
- Scroll to the Ban Area section
- Click Ban User
- Provide a reason for the ban
- Click Confirm
- User is immediately disconnected from all sessions
- User cannot log in until unbanned
- Ban reason is visible to the user
- Action is logged in audit logs
- Navigate to the banned user’s page
- Click Unban User
You cannot ban yourself or users with Owner rank.
Deleting Users
Permanently remove a user account:- Navigate to the user’s management page
- Scroll to the Danger Zone section
- Click Delete User
- Confirm the deletion
- Remove the user account
- Delete all their citizens
- Delete all citizen-owned vehicles and weapons
- Delete all pet records
- Disconnect the user from all sessions
- Log the action in audit logs
Whitelist Management
For CADs with whitelisting enabled: Accepting Users:- Go to the Pending Users tab
- Click Manage next to the pending user
- Click Accept this user
- Go to the Pending Users tab
- Click Manage next to the pending user
- Click Decline
Pruning Inactive Users
Remove inactive users in bulk:- Click Prune Users button
- Set the inactivity threshold (default: 30 days)
- Review the list of users who haven’t logged in within the threshold
- Select users to delete
- Click Prune Selected Users
- Owner rank users are never included in pruning
- Shows last seen date for each user
- Allows manual selection before deletion
- Logs the action in audit logs
User Search
Search for users using:- Username - Partial match, case-insensitive
- User ID - Exact match
- Steam ID - Exact match
- Discord ID - Exact match
Best Practices
- Use Custom Roles - Instead of assigning permissions individually, create custom roles for common permission sets
- Document Ban Reasons - Always provide clear ban reasons for transparency
- Regular Pruning - Periodically prune inactive users to maintain database performance
- Audit Log Review - Regularly review audit logs for user management actions
- Whitelist Promptly - Process pending users quickly to improve user experience
Troubleshooting
User Cannot Log In
- Check if the user is banned
- Verify whitelist status (if enabled)
- Check if the account exists in All Users
Permissions Not Working
- Verify permissions are saved (check audit logs)
- Ensure custom roles have the correct permissions
- Remember that role permissions override individual permissions
- Owner rank always has all permissions
Cannot Edit Owner
- Owner rank users cannot be edited for security reasons
- Transfer ownership through database if needed
Related Documentation
- Custom Roles - Learn about role-based permissions
- Audit Logs - Review user management actions
- CAD Settings - Configure whitelist and authentication