Overview
Values are the building blocks of your SnailyCAD configuration. They define selectable options throughout the system, such as vehicle types, departments, license categories, and more. Proper value management ensures your CAD reflects your community’s specific needs.Accessing Values
Navigate to Admin > Values to access the value management interface. You’ll see a list of all available value types.Available Value Types
Vehicle Values:- Vehicle - Vehicle makes/models (e.g., Ford, Chevrolet)
- Vehicle Trim Level - Vehicle trims (e.g., XLT, Sport, Limited)
- Vehicle Body Type - Body styles (e.g., Sedan, SUV, Truck)
- Vehicle Flag - Vehicle status flags (e.g., Stolen, Wanted)
- License - License types (e.g., Driver’s License, Pilot License)
- Drivers License Category - License categories (e.g., Class A, B, C)
- Blood Group - Blood types (e.g., A+, O-, AB+)
- Ethnicity - Ethnic backgrounds
- Gender - Gender options
- Citizen Flag - Citizen status flags (e.g., Gang Member, Dangerous)
- Address Flag - Location markers (e.g., High Crime Area)
- Department - Departments/agencies (e.g., Police, Sheriff)
- Division - Department divisions (e.g., Patrol, SWAT, K9)
- Officer Rank - Rank structure (e.g., Officer, Sergeant, Lieutenant)
- Qualification - Certifications (e.g., Firearms Instructor, Field Training Officer)
- Codes 10 - 10-codes by department (e.g., 10-4, 10-97)
- Emergency Vehicle - Department vehicles (e.g., Unit 1-Adam-12)
- Weapon - Weapon types (e.g., Glock 17, M4A1)
- Weapon Flag - Weapon status flags (e.g., Illegal, Stolen)
- Impound Lot - Vehicle impound locations
- Call Type - 911 call categories (e.g., Traffic Stop, Robbery)
- Penal Code - Laws and violations
Managing Values
Each value type has its own management page with consistent functionality.Viewing Values
The value list displays:- ID - Unique identifier (visible in developer mode)
- Value - The display name
- Is Disabled - Whether the value is active
- Created At - When the value was created
- Type-specific columns (e.g., Department, Color, Hash)
- Search - Filter by value name
- Sorting - Sort by any column
- Pagination - 35 values per page
- Drag and Drop - Reorder values by dragging rows
Creating Values
- Click Add [Value Type] button
- Fill in the required fields:
- Value - Display name (required)
- Type-specific fields (see below)
- Click Create
Editing Values
- Click Edit next to the value
- Modify the fields
- Click Save
Deleting Values
- Click Delete next to the value
- Confirm deletion
Bulk Deletion
- Select multiple values using checkboxes
- Click Delete Selected Values
- Review the count
- Confirm deletion
- Select all values on current page
- Click “Select all [X] items” to select across all pages
- Number of values successfully deleted
- Number of values that failed (in use)
Reordering Values
Values can be reordered by drag-and-drop:- Click and hold on a table row
- Drag to the desired position
- Release
- Changes are saved automatically
Value-Specific Fields
Department
- Value - Department name
- Type - Department type (LEO or EMS_FD)
- Callsign - Optional department prefix (e.g., “1” for 1-Adam-12)
- Whitelisted - Require approval to join
- Is Default - Default department for new units
- Default Officer Rank - Starting rank for new officers
- Color - Department color (hex code)
Division
- Value - Division name
- Department - Parent department (required)
- Callsign - Optional division prefix
- Paired Unit Template - Template for paired units
Emergency Vehicle
- Value - Vehicle name/callsign
- Department - Assigned department
- Divisions - Assigned divisions (optional)
Officer Rank
- Value - Rank name
- Department - Assigned department (optional)
- Image - Rank insignia (optional)
Vehicle
- Value - Vehicle make/model
- Game Hash - FiveM/game hash (optional)
- Trim Levels - Associated trim options
Penal Code
Managed separately at Admin > Values > Penal Code:- Title - Law name
- Description - Law description
- Type - Infraction, Misdemeanor, or Felony
- Bail Amount - Default bail
- Jail Time - Default sentence
- Fine Amount - Default fine
Importing Values
SnailyCAD supports bulk import from external sources:- Click the Options dropdown
- Select Import via file or Import from URL
- Follow the import wizard
- File Upload - Upload a JSON file
- URL Import - Import from a public URL
- Pre-made Templates - Use community templates
Imported values are added to existing values, not replaced. Duplicates are skipped.
Import Format
JSON format example:Exporting Values
- Click the Options dropdown
- Select Export
- Choose export format (JSON)
- Download the file
- Backup your configuration
- Share values with other communities
- Migrate to a new instance
Disabling Values
Instead of deleting values in use, disable them:- Edit the value
- Check Is Disabled
- Save
- Don’t appear in dropdowns for new records
- Remain visible on existing records
- Can be re-enabled at any time
Value Positions
Values display in the order defined by their position. This affects:- Dropdown menus throughout the CAD
- Reports and exports
- Mobile applications
Best Practices
- Consistent Naming - Use clear, consistent naming conventions
- Regular Cleanup - Disable unused values instead of deleting
- Department Structure - Plan your department hierarchy before creating divisions
- Import Templates - Start with community templates and customize
- Game Hashes - Use correct FiveM hashes for vehicle spawning
- Documentation Links - Reference the value documentation for each type
Troubleshooting
Cannot Delete Value
- In Use: The value is referenced by citizens, vehicles, units, etc.
- Solution: Find and remove all references, or disable the value instead
Import Failed
- Invalid Format: Check JSON syntax
- Missing Fields: Ensure all required fields are present
- Duplicates: Duplicate values are skipped automatically
Values Not Appearing
- Is Disabled: Check if the value is disabled
- Department Filter: Some values are department-specific
- Cache: Clear browser cache and refresh
Wrong Sort Order
- Drag-and-Drop: Use drag-and-drop to reorder
- Position Not Saved: Check for “Saving…” indicator after reordering
Related Documentation
- Value Types Documentation - Detailed guide for each value type
- Custom Fields - Add custom fields to value categories