Understaffed: headcount-gap franchisees

What the Understaffed row shows

Staffing shortfalls are one of the earliest warning signs of a franchisee in trouble: a location running below the headcount it told its own system it needs will miss callbacks, stretch its crew across too many jobs, and burn out the people it does have. The Understaffed row on the Workforce page is where Verinode surfaces exactly which franchisees are short, by how much, and how far along they are toward closing the gap, without ever showing HQ the private business detail behind that number.

This is a network-aggregate view. Verinode does not show HQ a franchisee's staffing plan, org chart, or role-by-role detail, only a single rolled-up gap figure per franchisee. The franchisee sets its own staffing target inside its own IQ workspace; HQ sees the outcome of that target, not the plan behind it.

Where to find it

Open Workforce from the HQ sidebar, at hq.verinode.ai/team. Workforce is the network-wide staffing and safety rollup, distinct from a single franchisee's own Team section, which HQ never sees directly.

The page opens on a hero panel (headcount, role mix, tenure, open incidents, OSHA history, covered in Network headcount hero), then a stack of horizontally scrolling rows. Understaffed is the first risk row beneath the hero, followed by Safety Risk, Bench Depth, Team Reviews, Work Style, and Team by Franchisee.

Where the numbers come from

Every franchisee configures its own custom role slots inside its IQ Team workspace (see Role slots): positions like Estimator, Lead PM, or Office Admin, each with a target headcount the franchisee sets for itself. Verinode does not derive this target on the franchisee's behalf and HQ never sets it.

Two numbers roll up from that:

• Target headcount is the sum of the target-headcount values across every custom role slot the franchisee has defined. A franchisee that hasn't defined any custom role slots has no target headcount at all, and does not appear anywhere in this row, not because it's fully staffed, but because there is nothing yet to measure it against.
• Headcount gap is target headcount minus active headcount: headcount_gap = target_headcount − active_count. A positive number means the franchisee is short; the row only ever lists franchisees where this gap is greater than zero. A franchisee sitting at or above its own target, or a franchisee with no target set, never shows up here.

This data flows into HQ once a day through Verinode's network aggregate refresh. A franchisee that closes its gap today (a new hire logged, or a role slot's target lowered) shows the update on Workforce the following day, not instantly.

Reading a tile

Each understaffed franchisee appears as a wide tile, up to six at a time, sorted with the largest gap first:

• Label, top-left: how many roles short, for example "-3 below." This is the raw headcount gap.
• Headline: the franchisee's name.
• Fill-percentage gauge: a colored arc showing active headcount as a percentage of target headcount, capped at 100%. Verinode computes this as round(active_count / target_headcount × 100). The arc's color reads the same way everywhere Verinode uses a gauge: red below 70% fill, amber from 70% up to 90%, green at 90% or above. A franchisee with no target headcount set shows no gauge at all, since there's nothing to measure fill against.
• Sub line: the plain-language version of the same math, for example "6 of 9 target headcount," active headcount over target headcount.
• Meta line: how many people at that franchisee are currently onboarding, for example "2 onboarding." This only appears when at least one member is mid-onboarding; a franchisee with nobody currently onboarding shows no meta line, meaning the gap has no active hires in flight yet.
• Accent color: the tile itself carries a signal color independent of the gauge. A gap of 3 or more roles short renders in Analyse red (an urgent, network-level shortfall); a gap of 1 or 2 renders in Maintain yellow (a watch-level shortfall).

Clicking a tile

Click any Understaffed tile and Verinode opens that franchisee's record in the Franchisees section (hq.verinode.ai/franchisees), scrolled directly to that franchisee's detail. This is the same tile-to-franchisee navigation used across every row on the Workforce page, and across every other HQ section: a risk tile is a shortcut into the one franchisee it's about, not a standalone report.

From the franchisee's detail you see the aggregate profile HQ is entitled to (compliance status, benchmark position, program participation, and so on), not the franchisee's internal staffing roster. The privacy boundary holds all the way through: Workforce told you a gap exists and how large it is, the franchisee record tells you who this franchisee is in the network, and the conversation about which role to fill and when stays with the franchisee.

Empty state

When every franchisee that has set a role-slot target is at or above that target, the row reads:

"All franchisees with role-slot targets are at or above headcount."

This is not the same as "every franchisee is fully staffed." A franchisee that has never defined a custom role slot has no target headcount, no headcount gap, and no way to appear in this row, staffed or not. The Understaffed row can only ever speak for franchisees that have told Verinode what "fully staffed" means to them.

How to use it

Sort priority is already done for you: the row lists the largest gaps first, and a red tile (3 or more roles short) deserves a look before an amber one. A franchisee with a low fill percentage and no onboarding meta line is the one worth a call this week, the gap is real and nothing is currently in motion to close it. A franchisee with a similar gap but an active onboarding count is already working the problem.

Because this row only reflects franchisees that have set their own target, a location that never shows up here is either genuinely at capacity or simply hasn't configured role-slot targets yet. If a franchisee you'd expect to see flagged never appears, that's worth a conversation about whether they've set targets at all, not an assumption that staffing is fine.

Related reading

• Network headcount hero: the panel above this row, with total headcount, role mix, tenure, and incident counts.
• Role slots: how a franchisee builds the custom role slots that feed target headcount, on the IQ side.
• The Team section: the franchisee-facing Team home page this data rolls up from.
• Members: the franchisee's own roster, which HQ never sees directly.