Skip to main content

Personnel Roles

Personnel Roles allow you to define functional roles within your department and assign them to personnel. Roles represent capabilities, qualifications, or job functions (such as "Firefighter", "EMT", "Officer", "Driver/Engineer") rather than organizational positions. Roles are used throughout Resgrid for dispatch targeting, notification rules, permissions, and availability tracking.

Why Personnel Roles Matter​

Roles provide a powerful way to organize your personnel by capability rather than just by group. When dispatching a call, you can dispatch to a role (e.g., "All EMTs") rather than selecting individuals. Notification rules can target roles to alert specific skill sets when conditions change. Permissions can be granted to roles, allowing you to give specific access without making someone a full administrator.

Scope​

Personnel Roles are department-wide. Each role has a name, description, and a list of members. A person can belong to multiple roles simultaneously (unlike groups, where each person can only be in one group).

Viewing Roles​

Navigate to Personnel → Manage Roles to see all roles defined in your department. The list shows each role's name and member count.

Creating a Role​

Click Add Role to create a new personnel role.

Role Fields​

FieldRequiredDescription
NameYesThe name of the role (must be unique within the department)
DescriptionNoA description of what the role represents
MembersNoDepartment personnel assigned to this role
Custom iconNoAn image shown on the map pins of the role's members, by role order (see below)

When creating a role, you can assign members immediately, or create the role first and add members later by editing it.

Unique Role Names

Each role name must be unique within your department. If you attempt to create a role with a name that already exists, you will receive a duplicate name error.

Editing a Role​

Click on a role to edit its name, description, or member list. You can add or remove members at any time. Changes take effect immediately.

Role order and map icons​

Give a role a custom icon on Add Role or Edit. The picker shows the image rules and previews the icon on a light map, a dark map and in a list before you save. The rules and messages are the same as for unit and call type icons.

Role icon picker

A person can hold several roles, so their map pin uses the icon of the first role they hold, in the role order, that has an icon. Department administrators set the order on Manage Roles: drag the rows or use the arrows, then click Save order. Until you save an order, roles are listed by name. A role added later goes to the end of a saved order.

Roles with icons and order controls

Put the roles you most want to see on the map first. For example, order Officer above Paramedic above Firefighter: an officer who is also a paramedic shows the officer icon, and a firefighter-paramedic shows the paramedic icon. People whose roles have no icon keep the standard person pin. To remove a role's icon, tick Remove the custom icon on Edit and save. Deleting a role deletes its icon.

A role can also have an icon for each personnel status: Edit the role and choose Status map icons. A member whose map icon comes from the role shows the status icon while they are in that status, and the role's own icon with a colored status badge otherwise. Members with no role icon show the person pin in the color of their status. See Status and priority icons and the Map icon legend.

The order and icons also reach the apps: the Unit, Responder, IC and Dispatch apps draw the icon on personnel map pins, and the Responder, IC and Dispatch personnel lists show it beside each person.

Deleting a Role​

Roles can be deleted from the role list. Before deleting a role, consider the impact on:

  • Dispatch rules — if the role is used as a dispatch target
  • Notification rules — if notifications target this role
  • Permissions — if the role is used in "Department Admins and Select Roles" permission settings
  • Unit assignments — if personnel in this role are assigned to units based on their role
Review Dependencies Before Deleting

Before deleting a role, check Notifications, Permissions, and any dispatch configurations that reference the role. Removing a role that is actively used in these features could cause notifications to stop firing or permissions to change unexpectedly.

How Roles Are Used in the System​

FeatureHow Roles Are Used
DispatchDispatch to a role sends notifications to all members of that role
NotificationsNotification rules can target roles as recipients
Permissions"Department Admins and Select Roles" permission level uses roles
AvailabilityAvailability alerts can monitor specific roles (e.g., alert when fewer than 3 EMTs are available)
UnitsUnit roles define positions on a unit (e.g., Driver, Officer, Firefighter) that map to personnel roles
ReportsPersonnel roles appear in reports and personnel exports
MappingA person's map pin uses the icon of their first role, in role order, that has one

Roles vs Groups​

It's important to understand the difference between roles and groups:

AspectRolesGroups
PurposeFunctional capability / job functionOrganizational structure / location
MembershipPerson can have multiple rolesPerson can only be in one group
ExampleEMT, Officer, Firefighter, DriverStation 1, Alpha Team, Division 2
DispatchDispatch by capabilityDispatch by organization

Common Errors and Resolutions​

ErrorResolution
"Role name already exists"Choose a unique role name
Cannot delete roleCheck for dependencies in Notifications, Permissions, and Dispatch
Person not receiving role-based dispatchVerify the person is a member of the role
Role members not showing correctlyEnsure members have been saved; refresh the page