Manage Ranks

Define the ranks your agency uses and see how many members hold each one.

Ranks describe the positions or levels within your agency — captain, lieutenant, firefighter, probationary, and so on. The Manage Ranks screen lists each rank as a card showing its name, abbreviation, how many members hold it, and its state. As an agency administrator you can add new ranks and edit existing ones, each with a name and a short abbreviation of up to four characters.

info

This screen is part of the Admin Tools and requires an agency administrator role. If you do not have admin access, you will not be able to reach it.

Overview

Each rank is a card with four lines of text and a blue pencil button in the bottom-right corner.

Line on the card	What it shows
Rank:	The rank's name, in bold.
Abbreviation:	A short code, up to four characters.
Users:	How many members currently hold this rank.
State:	The rank's current state, such as active.

The three-dot button at the top right holds a single menu choice: Add Rank.

note

There is no delete button on this screen. Ranks are retired by changing their state on the server rather than being removed from the app, so the historical record of who held what stays intact.

Getting Here

1. Open the Account tab and tap the Settings module to reach Agency Settings.
2. Expand the Overview section in the settings list and tap Ranks.
3. The Manage Ranks screen opens with a card for each rank after a brief spinner.
4. Tap the Back arrow to return to the settings list.

Adding a Rank

1. Tap the three-dot menu at the top right and choose Add Rank. The add screen opens with both fields empty.
2. Enter a Rank Name.
3. Enter an Abbreviation. This field accepts at most four characters — it simply stops taking input beyond that.
4. Tap Save. A confirmation message appears and the new rank is added to the list.

Fields on the Add Rank form

Field	Type	Required?	Notes
Rank Name	Single-line text	Yes	The full name, as you want it read.
Abbreviation	Single-line text	Yes	Capped at four characters.

Messages you may see when saving

Message	What it means
"Please enter rank name"	The Rank Name field is empty.
"Please enter abbreviation"	The Abbreviation field is empty.

On success, the server's own status message appears briefly and you return to the list, which reloads.

tip

Keep abbreviations short and consistent — they are what appear next to members' names in other parts of the app, where there is rarely room for the full rank. Four characters is the limit, so decide early whether you are using CAPT or CPT and stick with it across every rank.

Editing a Rank

1. Find the rank and tap its blue pencil (Edit) button.
2. The Edit Rank screen opens with the name and abbreviation already filled in.
3. Change the name or abbreviation as needed. Both stay required.
4. Tap Save. The list reloads with your changes.

If you tap Back with unsaved changes, the app asks "Data Updated — Do you want to save changes?":

Choice	What happens
Save	Runs the name and abbreviation checks, then saves and returns to the list.
Cancel	Discards your edits and returns to the list.

Tapping Back with nothing changed returns to the list without asking.

caution

Renaming a rank changes it for every member who holds it, immediately and everywhere. If you want a genuinely different position, add a new rank and reassign people to it from Manage Members rather than renaming the old one.

Loading and Empty States

Situation	What you see
Opening the screen	A brief spinner, then the cards.
Your agency has no ranks	An empty list. Use Add Rank to create the first one.
The server does not answer	An alert shows the error and the list stays empty.
Offline	This screen needs a connection. Expect an error alert.
A rank nobody holds	Its card still shows, with Users: reading 0.
After adding or editing	The list reloads on its own so the counts are current.

note

Manage Ranks keeps no offline copy — it fetches fresh from the server each time you open it. There is no queue, so adding or editing a rank needs a live connection.

How This Connects

• Where the data comes from. The rank list is fetched from your agency's server every time you open this screen.
• What updates it. Adding and editing here. The Users: count is calculated on the server from your member records — you cannot type it in. Assigning a rank to someone on Manage Members moves that count.
• Ranks feed the member assignment popup. The Rank dropdown in the Assign popup on Manage Members lists None followed by every rank defined here. That is how a specific person gets a rank.
• Ranks feed the invite defaults. The default rank pre-selected on the Add New Member form in Memberships comes from this list, so every new member starts with a sensible rank.
• Ranks show on member records. The Rank: line on a member's detail popup in Manage Members, and the Rank line a member sees on their own Personal Profile → Agency Info, both come from here.
• Ranks show in the Directory. A member's rank appears beside their name in the Directory and on their Directory User Detail page — which is where the four-character abbreviation earns its keep.
• Ranks show in command. Command personnel views such as Command Resources and Command Unit Overview display rank so an incident commander can see who is senior on scene at a glance.
• The rank count is on the agency card. The rank count in the summary block of Agency Profile reflects how many ranks exist here.
• Alongside groups and statuses. Ranks say what position; groups say which team; statuses say what standing. A member usually has one rank, one status, and several groups.
• Offline and reconnect. Nothing is queued on this screen. Loading, adding, and editing all need a live connection. Reopen the screen once you are back online.

Troubleshooting

If this happens	What to do
You cannot reach this screen	It requires an agency administrator role. Ask an existing admin.
An error alert appears instead of cards	This screen needs a connection every time. Check your signal and reopen it.
"Please enter rank name" blocks your save	Type a name and save again.
"Please enter abbreviation" blocks your save	The abbreviation is required. Type up to four characters.
The Abbreviation field stops accepting letters	It is capped at four characters by design. Shorten it.
There is no delete button	Ranks are not deleted from the app. Reassign the members who hold it, then have its state changed on the server.
Users: shows 0 for a rank you expect people to hold	Nobody has been assigned it yet. Use the Assign popup on Manage Members.
A rank is missing from the Assign dropdown	That dropdown is filled in when the popup opens. Close it and tap Assign again.
A rank is missing from the invite form	Same — close the Add New Member form and reopen it.
A rank you renamed still shows the old name elsewhere	Other screens read the list when they open. Reopen the screen you are looking at.
A teammate's new rank is missing	Reopen this screen. Server changes arrive on refresh.
Abbreviations look inconsistent across ranks	Edit each one so they follow the same style — it matters most in the narrow spaces where only the abbreviation fits.

Related Pages

• Manage Statuses
• Manage Groups
• Manage Members
• Agency Settings

---

⬅️ Previous: Manage Members | Next: Manage Statuses ➡️