Skip to main content

Types & Configuration

Types are the pick-lists the rest of Resgrid is built on: unit types (Engine, Ambulance, Patrol car), call types (Fire, Medical, Alarm), call priorities (with colours, sounds and dispatch behaviour), certification types, document categories, note categories, contact note types and the personnel status list ordering. Set them up early — dispatch, run cards, NERIS crosswalks, custom statuses and reports all refer to them.

Department menu → Types.

Types

Unit Types​

Define categories for units (Engine, Ladder, Ambulance, etc.):

New unit type

FieldDescription
Type NameUnit type name (required, unique)
ClassWhat kind of unit it is (Engine, Aerial, Ambulance …), see Classes and meanings
Custom State IDAssociate with a custom unit state set
Map Icon TypeBuilt-in icon used on maps
Custom iconOptional image of your own. Units of this type show it beside their name in lists, pickers and the apps, and on the map in place of the map icon. See Custom map icons
Status map iconsOn Edit: opens the page where you upload an icon for each status of the type's status set, shown on the map while a unit of the type is in that status. See Status and priority icons

The Custom icon field shows the image rules next to the file picker and a live preview: how the icon looks on a light map, on a dark map, in a list and as the stored 128 × 128 image. It is labelled with the type name you typed. The file is checked as soon as you choose it, so a file that cannot be used is never uploaded.

Custom icon picker with a new icon chosen

Operations​

  • Create — Department_Update + CanUserAddUnitTypeAsync
  • Edit — Department_Update + CanUserEditUnitTypeAsync; validates no duplicate names
  • Delete — Department_Update + authorization check

All operations fire audit events with before/after snapshots.

Call Types​

Define incident categories (Fire, EMS, MVA, etc.):

New call type

FieldDescription
Type NameCall type name (required)
ClassWhat kind of call it is (Fire, Medical, Rescue …), see Classes and meanings
Map Icon TypeBuilt-in icon used on maps
Custom iconOptional image of your own. Calls of this type show it beside the type in the call lists and the apps, and on the map in place of the map icon. See Custom map icons
Priority map iconsOn Edit: opens the page where you upload an icon for each call priority, shown on the map while a call of the type has that priority. See Status and priority icons

Calls remember which call type they were logged with, so renaming a call type keeps its old calls linked to it (check-in timer overrides, run cards and protocols keyed on the type still apply to them). Protocol triggers and call templates that name the type are renamed with it.

Operations​

  • Create — Department_Update + CanUserAddCallTypeAsync
  • Edit — Department_Update + CanUserModifyCallTypeAsync
  • Delete — Department_Update + authorization check

Call Priorities​

Define urgency levels for calls with visual and audio indicators:

New call priority

FieldDescription
Priority NameDisplay name (required, unique)
MeaningWhich standard priority it means: Low, Medium, High or Emergency, see Classes and meanings
ColorPriority color (hex)
Is DefaultDefault priority (only one allowed)
Dispatch PersonnelWhether to auto-dispatch personnel
Dispatch UnitsWhether to auto-dispatch units
Force Notify AllForce notification to all personnel
ToneAlert tone selection
Alert SoundWAV file upload (≤1 MB)
note

Push notification and iOS push sound upload features are currently disabled (code commented out).

Operations​

  • Create — Validates single-default rule and name uniqueness
  • Edit — Same validations
  • Delete — Soft-deletes (IsDeleted = true)

Until you add a priority of your own, calls use the four built-in priorities (Low, Medium, High, Emergency). Once you add one, your priorities replace the built-in ones.

A priority's meaning also sets the color of its calls' map pins (icons by status and priority): Low green, Medium yellow, High orange, Emergency red, and gray for a priority with no meaning whose name suggests none. The Map Icon Legend lists each of your priorities under the color it takes.

Classes and meanings​

Call types, unit types and call priorities are named however your department likes: Code 3 Medical, Pumper, Priority 1. A class (call and unit types) or meaning (priorities) tells Resgrid what each one is, the same way a status meaning does for statuses. Resgrid uses it, not the name, for reports, defaults and integrations, and for comparing priorities across departments and apps, such as sorting by urgency. A new or existing type starts with None.

The edit page shows Suggested from the name: … under the picker when the name gives a clear hint, for example Fire for STRUCTURE FIRE. It is only a hint: Resgrid never sets a class for you, so pick it and press Update to keep it.

Edit Call Type: the Class picker on None with "Suggested from the name: Fire"

Edit Unit Type: the Class picker on None with "Suggested from the name: Engine"

Edit Call Priority: the Meaning picker on None with "Suggested from the name: Emergency"

ListChoices
Call type classFire, Medical, Rescue, Traffic Collision, Hazardous Materials, Alarm, Service Call, Law Enforcement, Disaster or Weather, Mutual Aid, Non-Emergency Activity (training, drills, standby, planned events), Other
Unit type classEngine, Aerial, Rescue, Tanker, Ambulance, Medical Response (non-transporting), Wildland, Hazardous Materials, Command, Support, Watercraft, Aircraft, Patrol, Other
Priority meaningLow, Medium, High, Emergency. The built-in priorities are their own meaning.

The classes are deliberately broad so they fit any country and discipline. NERIS incident types are mapped separately, on Records incident reports.

Your nameClass or meaning
Call type STRUCTURE FIRE, Brush Fire, Vehicle FireFire
Call type MVA, TRAFFIC ACCIDENTTraffic Collision
Call type Lift Assist, LockoutService Call
Call type Fire AlarmAlarm
Call type SAR, Missing HikerRescue
Unit type Pumper, QuintEngine, Aerial
Unit type Medic, ALS, QRVAmbulance, Ambulance, Medical Response
Unit type Brush, Tender, UtilityWildland, Tanker, Support
Priority Code 3, EchoEmergency
Priority Routine, Non-emergencyLow

Certification Types​

Define categories for personnel certifications (EMT-B, Paramedic, Firefighter I, etc.):

FieldDescription
Type NameCertification type name (required, unique)

The Manage typed catalog button opens the full Certifications module, where each type also gets a stable code, category, person/unit scope, default validity, verification and credit-hour rules, and where you can add 90+ common credentials from the template gallery. Types created here appear in that catalog too; open them there to add the code, scope and rules.

Document Categories​

Categorize department documents:

FieldDescription
Category NameDocument category name (required, unique)

Note Categories​

Categorize department notes:

FieldDescription
Category NameNote category name (required, unique)

Contact Note Types​

Categorize notes on external contacts with color coding:

FieldDescription
Type NameNote type name (required, unique)
ColorDisplay color for the note type

Operations​

  • Create, Edit (with CanUserEditContactNoteTypeAsync), and Delete

Personnel Status List Ordering​

Configure the sort order of personnel statuses in the dashboard view:

  • Define which statuses appear in the list
  • Set the display order (weight-based)
  • Add or remove statuses from the ordered list

Common Patterns​

Validation​

All types validate:

  • Name is not empty
  • Name is unique within the department (no duplicates)

Audit Trail​

Every create, edit, and delete operation fires an AuditEvent with:

  • Audit log type (e.g., UnitTypeAdded, CallTypeEdited, CertificationTypeRemoved)
  • Before/after JSON snapshots for edits
  • IP address and user agent

Two-Layer Authorization​

All operations use:

  1. ASP.NET [Authorize(Policy = "Department_Update")] attribute
  2. Resgrid's IAuthorizationService for fine-grained checks

Setup examples​

Department typeHow to set it up
Volunteer / career fireUnit types: Engine, Ladder/Truck, Rescue, Tender, Brush, Command, Utility. Call types: Structure fire, Vehicle fire, Brush/wildland, Alarm, MVA, Medical, Hazmat, Public assist, Water rescue. Priorities: Low, Medium, High, Emergency (Emergency = full alert sound, overrides quiet hours). Certifications: FF1, FF2, Driver/Operator, EMT, Officer 1.
EMSUnit types: ALS, BLS, Supervisor, Wheelchair van. Call types by nature (Cardiac, Trauma, Respiratory, IFT, Standby). Priorities Echo/Delta/Charlie/Bravo/Alpha/Omega if you follow MPDS. Certifications: EMT, AEMT, Paramedic, CPR, ACLS, PALS.
SARUnit types: Ground team, K9 team, Technical team, UTV, Drone. Call types: Missing person, Overdue hiker, Rescue, Recovery, Evidence search, Mutual aid, Training. Certifications: SARTECH II, Wilderness first aid, Rope tech.
Emergency managementUnit types: EOC section, MCV, Trailer. Call types: Activation, Weather event, Resource request, Shelter opening, Exercise. Priorities: Monitoring, Partial activation, Full activation.
CERTUnit types: CERT team; call types: Deployment, Training, Community event.
SecurityUnit types: Patrol vehicle, Foot post, Bike; call types: Alarm, Suspicious activity, Escort, Medical, Fire alarm, Access control. Priorities: Routine, Urgent, Emergency.
Delivery / transitUnit types: Van, Truck, Bus; call types: Delivery, Pickup, Breakdown, Accident, Passenger incident. Priorities by SLA.
Industrial ERTUnit types: Fire brigade, Hazmat, Rescue, Medical; call types: Fire, Spill/release, Confined space, Medical, Evacuation, Drill; certifications for every OSHA/NFPA qualification.

Technical reference​

TypesController (+ Department/Types index page); routes /User/Types/{NewUnitType,EditUnitType,NewCallType,EditCallType,NewCallPriority,EditCallPriority,NewCertificationType,NewDocumentType,NewNoteType,NewContactNoteType,ListOrdering}; model UnitType, CallType, DepartmentCallPriority (colour, sound, IsDefault, Tone, DispatchPersonnel/Units), CertificationType, DocumentCategory, NoteCategory, ContactNoteType.

ItemValue
Classes and meaningsCallType.BaseType (a CallTypeClasses value), UnitType.BaseType (UnitTypeClasses), DepartmentCallPriority.BaseType (a CallPriority value, 0 Low to 3 Emergency; built-in priorities are their own). -1 = none. A posted value that is not in the enum is saved as -1
SuggestionsBaseTypeSuggestions.SuggestCallTypeClass, SuggestUnitTypeClass, SuggestPriority; shown on the edit pages only while the value is -1, never saved on their own
Call type linkCall.CallTypeId: the call type a call was logged with (Call.Type keeps the name). Worked out from the name when a call is saved (CallTypeLink); a call already linked keeps its link after a rename. Null when the name matches no call type
RenameEditing a call type's name also renames it in protocol triggers (IProtocolsService.RenameCallTypeInTriggersAsync) and call quick templates (ITemplatesService.RenameCallTypeInTemplatesAsync)
APIv4 CallTypes and CallPriorities results include BaseType; v4 call results include TypeId (the linked call type's id, or null)
Custom iconsUnitType.IconKey / CallType.IconKey point at the type's row in TypeIcons (migration M0285). Uploads are read by TypeIconUploads, checked and re-encoded by TypeIconRenditions (PNG, JPEG, GIF first frame or WebP; at most 1 MB and 4096 px; at least 16 px; stored as a 128 × 128 transparent PNG) and saved after the type's own fields. The picker is the shared partial _TypeIconPicker with resgrid.types.iconpicker.js. Deleting a type deletes its icon. See Custom map icons
MigrationM0272 (M0272_AddListBaseTypes, PostgreSQL M0272_AddListBaseTypesPg): adds BaseType (default -1) to CallTypes, UnitTypes and DepartmentCallPriorities, adds Calls.CallTypeId and links existing calls to their department's call type of the same name

Interactions with Other Modules​

ModuleInteraction
UnitsUnit types categorize units
DispatchCall types and priorities used in call creation
Custom StatusesUnit types reference custom state sets
DocumentsDocument categories used for filtering
NotesNote categories used for filtering
ContactsContact note types used for note classification
CertificationsCertification types used in personnel profiles
MappingMap icon types, custom icons and status / priority icons for calls and units (Custom map icons, Map icon legend)
DashboardPersonnel status ordering affects status display