Peer scope & confidence on commercial metrics

What this article covers

Every per-franchisee slider in the Commercial section carries a peer-comparison line under each number: a median, a percentile, and a confidence tier. Those three things come from a scope you choose, Group, Regional, or National, and each scope has its own rules for when it is allowed to show a number at all. This article explains how the scope switcher works, why some scopes show a real median and others show a pending message, what the confidence tiers mean, how direction-of-good decides whether a number is read as good or bad news, and what every empty state on this slider means. It applies specifically to the per-franchisee Commercial drill, the same scope mechanics also appear on Facilities, Fleet, and Equipment.

Where to find it

Open Accounts from the HQ sidebar, then the Commercial tab, at hq.verinode.ai/commercial (the Accounts cluster is Carriers, TPAs, Commercial, three tabs across the top of the page). Commercial is the franchisee's direct business-to-business revenue book: commercial versus retail job counts, billed and collected dollars, cash cycle, and top-client concentration. Insurance carrier and TPA work is a separate book, covered by the Carriers and TPAs tabs, not this one.

Click any franchisee tile, on the Largest Commercial Books row or the All Franchisees row, to open the Commercial slider for that franchisee. The slider is a centered overlay with the franchisee's name, location (or "Location anonymized"), status, and a commercial-versus-retail client-count pill at the top. Every number below the header belongs to that one franchisee; HQ never sees their underlying invoices, client list, or job records, only the rolled-up figures the slider displays.

The scope switcher: Group, Regional, National

Directly under the franchisee's name is a row of pills, the scope switcher. It reads Group (N), Regional, and National, where N is the number of peers available at that scope. This is the "compare against who" control:

• Group compares the franchisee against other active franchisees in your own network (your group).
• Regional compares against peers in the same state, across the wider Verinode network.
• National compares against peers anywhere in the Verinode network.

Clicking a pill re-renders every metric tile below using that scope's median, percentile, and confidence. The active pill is filled in copper; the other two remain visible even when they have nothing to show, so you can see the dimension exists rather than have it disappear.

A pill that does not yet have enough peers renders disabled, with a tooltip explaining why:

• Group, disabled with "Need 3+ active peers in the network for within-network comparisons" when your network has fewer than three active franchisees contributing this metric.
• Regional, disabled with "Need 3+ peers in the same state. Smaller state cohorts hidden by K-anonymity floor" when the franchisee's state doesn't have enough contributing peers.
• National, disabled with "Cohort too small for cross-network comparison" when the same floor isn't met network-wide.

The 3-peer availability floor

Every peer comparison on this slider, at every scope, needs a minimum number of contributing peers before Verinode will show a median or percentile at all. This is a K-anonymity floor: showing a "median" built from one or two other franchisees' numbers would let a sharp reader back-solve what a specific peer's figure is, which breaks the confidentiality every franchisee is entitled to. Verinode does not publish a comparison until enough distinct businesses sit behind it that no single one can be reverse-engineered.

When a scope falls below that floor, the metric tile shows "Cohort too small" instead of a median, and the tile's unavailableReason is cohort_too_small. This is different from a scope having no data at all (see the Regional/National section below), a too-small cohort means peers exist but there aren't enough of them yet to protect anonymity.

The floor applies independently per metric and per scope. A franchisee's Group scope can clear the floor on Commercial clients while a rarer metric like Concentration vs peers stays hidden, because the floor is counted against how many peers actually have a usable value for that specific metric, not just how many franchisees exist in the group.

Confidence tiers: High, Directional, Low, Hidden

Once a scope clears the availability floor, every median carries a confidence tier based on how many peers are behind it. More peers means the median is less likely to be skewed by one or two outlier businesses:

| Tier | Label shown | What it means | |---|---|---| | High confidence | "High confidence" | A large peer cohort backs this median. Treat it as a reliable industry-level number. | | Directional | "Directional" | A moderate peer cohort. Useful for spotting a trend, less precise than High. | | Low confidence | "Low confidence" | A small peer cohort, just above the availability floor. Read this as a rough signal, not a precise benchmark. | | Hidden | "Hidden" | Below the availability floor, no median is shown at all (this is the cohort_too_small state above). |

You won't see exact peer counts published anywhere in the product, HQ deliberately keeps the specific thresholds behind each tier out of view so the boundary itself can't be used to infer who is or isn't in a cohort. What you do see is the tier label and, on the Group scope's footer line, the confidence tier alongside a sample-size note (for example, "Within-network comparison · Directional · n=8"). Trust the label; don't try to reverse-engineer the count from it.

Reading the peer-comparison line on each tile

Under the franchisee's raw value, each metric tile shows:

• Median [value], the peer group's midpoint for that metric at the active scope, formatted the same way as the franchisee's own number (dollars, days, count, or percent).
• · p[N], the franchisee's percentile rank inside that peer group, only shown when a percentile could be computed.
• A delta line underneath, in copper-family tones, reading either "On par with peers" (within 5% of the median), or a signed percentage like "+18% vs median" / "-12% vs median".

The delta line's color depends on direction-of-good, not simply on whether the number is above or below the median:

| Metric | Direction of good | |---|---| | Commercial clients | Higher is better (a larger B2B book signals a stronger demand pipeline) | | Commercial jobs (36mo) | Higher is better | | Commercial billed (36mo) | Higher is better | | Collection rate | Higher is better (better collection efficiency) | | Avg days to pay | Lower is better (a faster cash cycle) | | Concentration vs peers (top-client share) | Lower is better (single-client concentration is a risk, not a strength) |

So a franchisee whose Avg days to pay sits 20% below the peer median gets a green "on the right side" reading, while a franchisee whose Concentration vs peers sits 20% above the median gets flagged, even though both are "above" or "below" in a purely numeric sense. When the peer median itself is zero, Verinode either reads "On par with peers" (if the franchisee is also at zero) or shows no delta at all, a percentage-off-zero would be meaningless.

If a program target is active for a metric, a second line appears under the delta: "✓ Meets target" or "✗ Below target", followed by the target value in parentheses (for example, "(target 30d)"). Hovering the tag shows which network program set that target. This is separate from the peer comparison, a franchisee can beat the peer median and still miss a program-specific target, or vice versa.

What the slider covers

The Commercial slider is organized into three sections, all peer-compared through the same scope switcher:

Book size. Commercial clients, Commercial jobs (36mo), Commercial billed (36mo), and Collection rate (collected dollars as a percent of billed dollars over the trailing 36 months).

Cash cycle. Avg days to pay, the franchisee's average time from billing a commercial job to getting paid.

Concentration risk. This section only appears when the franchisee has a named top commercial client on record. It shows the Top client name, Top client billed (36mo), and Share of commercial book (the top client's billed dollars as a percent of the whole commercial book), each colored by risk tier: green under 30% (healthy diversification), yellow 30 to under 50% ("Watch concentration, top client is a meaningful share"), red 50% and up ("Single-client revenue risk, losing this account is structural"). Below those three numbers, a Concentration vs peers tile runs the same scope-switched peer comparison as every other metric.

Regional and National: the honest pending state

Regional and National scope today only compute a real number for one metric, Commercial clients. Every other Commercial metric, Commercial jobs (36mo), Commercial billed (36mo), Collection rate, Avg days to pay, and Concentration vs peers, shows "Pending benchmark seed" at Regional and National scope, because the industry-wide data those benchmarks need doesn't exist yet across the Verinode network for commercial-category jobs specifically.

This is not a bug or a broken control, it's a deliberate honest state: Verinode will not show you a fabricated or demo-derived "national average" dressed up as real industry data. The scope-context footer at the bottom of the slider spells this out directly:

• At Regional scope: "Regional industry benchmarks pending, commercial metrics will seed via the benchmark data in the next slice."
• At National scope: "National industry benchmarks pending, commercial metrics will seed via the benchmark data in the next slice."

At Group scope, the footer instead reads either "Peer cohort too small, need 3+ active franchisees in the network" (when your own network hasn't cleared the floor) or a confidence summary like "Within-network comparison · Directional · n=8" once it has.

As the commercial-category job pipeline matures across the network, more metrics will light up at Regional and National scope the same way Commercial clients already has, no action is needed on your end, the numbers will simply start appearing once enough of the network is contributing commercial-job data.

Empty states you'll see

• Slider fails to load: "Couldn't load this franchisee's commercial book." with a Close link. Retry by reopening the tile.
• No top commercial client on record: the entire Concentration risk section is omitted from the slider, it only renders when a top client name exists.
• A metric has no peer data at the current scope: the tile shows "Cohort too small" (below the K-anonymity floor) or "Pending benchmark seed" (Regional/National not yet computed for that metric) instead of a median.
• Aggregate-only view banner: if your whole network has fewer than three active franchisees, a copper-accented notice above the row stack reads: "Aggregate-only view. Your network currently has fewer than three active operators, so per-franchisee commercial book tiles are suppressed to protect operator privacy (small-cohort identification risk). Hero aggregates still surface. Tiles return once the network reaches 3+ active operators, or change the network data posture in Settings → Group → Data posture." Franchisee-level tiles across Largest Commercial Books, All Franchisees, and Concentration Risk are all suppressed together in this state; the page-level hero numbers keep showing.
• No commercial clients across the network yet: the hero panel reads "Commercial clients will appear as franchisees register direct B2B accounts."
• No cross-franchisee named commercial clients yet: the Top Commercial Clients by Spend row reads "Cross-franchisee commercial clients will appear here once jobs flow through with named clients," plus a note on how many single-franchisee clients are currently hidden under K-anonymity, when any are.
• No client served by more than one franchisee: the Most Shared Commercial Clients row reads "No commercial clients are served by more than one franchisee yet. Cross-network clients appear here when the network bills the same client through multiple operators."
• No franchisee over the concentration threshold: the Concentration Risk row reads "No franchisee shows more than 50% of its commercial book on a single client."
• No rollup data yet: the All Franchisees row reads "No franchisees rolled up yet. Data appears after the next nightly aggregation."

How to use this in practice

Start at Group scope, it's the most complete and the most relevant to your own network's health. Use the delta line and direction-of-good coloring to spot franchisees whose cash cycle or concentration risk is diverging from the rest of the network, not just whose raw dollar figures are largest. Switch to Regional or National only on metrics that already show a live median there today (currently Commercial clients), and treat "Pending benchmark seed" everywhere else as a placeholder for benchmarks still filling in across the industry, not as a data gap in this one franchisee's numbers.

If a franchisee's concentration risk is flagged, use the peer comparison to check whether that's a network-wide pattern (concentration running high across many franchisees, a business-model characteristic worth discussing at the program level) or an outlier at that one location worth a direct conversation.

Related articles

• /help/hq-overview
• /help/network-health
• /help/hq-benchmarks
• /help/hq-programs
• /help/hq-standards
• /help/hq-compliance

Data sources