Inside a program: the detail view and its rows

What this page is

Every program in your network catalog, an approved-vendor panel, a carrier partnership, a TPA relationship, a certification mandate, a training requirement, a brand standard, a safety program, opens onto one shared detail page. Verinode builds that page from the same adapter every time: a hero panel at the top, then a stack of rows underneath it. Which rows actually appear is decided at build time from two things about the program you clicked into: its type (vendor approval, carrier, TPA, cert mandate, training, brand standard, safety) and its enrollment model (mandatory, opt-in, or approved-party list). This article walks through the hero, the row-selection logic, and every row you can encounter.

One program type is the exception. Marketing co-op programs do not use this page at all. Click into a co-op program from the catalog and Verinode redirects you straight to its own dedicated ledger surface, because a co-op is a running reimbursement account, not a roster of parties or franchisees. Everything below applies to the other seven program types.

Where to find it

1. 1Open Programs from the HQ sidebar at hq.verinode.ai/programs.
2. 2Find the program you want in the Active, Drafts, or Sunset row (optionally narrow the catalog first with the type-filter tabs, see hq-programs-type-filter-tabs).
3. 3Click the program's tile. You land on hq.verinode.ai/programs/[id], the page this article covers.
4. 4The page title at the top is the program's name. Below it, the hero panel and the row stack follow the same shell every entity detail page in Verinode uses: sticky title, rows underneath, nothing scrolls out from under the header.

The hero panel

The hero is the first thing you see and it never disappears, whatever rows follow it. It has five parts.

Eyebrow. A small label above the headline naming the program type: "Approved vendor program," "Carrier program," "TPA program," "Certification mandate," "Training program," "Brand standard," or "Safety program."

Headline number. The single biggest number for this program, and what it counts depends on the enrollment model:

• Approved-party list programs (vendor approval, carrier, TPA, when set up that way) headline the count of qualified parties, approved vendors, carriers, TPAs, labs, or brokers that have cleared to qualified status.
• Mandatory or opt-in programs (cert mandate, training, brand standard, safety) headline the count of active enrollments, franchisees currently attached to the program.

Status pill, next to the headline: Active (green), Draft (neutral gray), Sunset (amber), or Archived (neutral gray). This is the program's lifecycle state, not a per-franchisee status.

Subtext line, one sentence under the headline. If the program has a description written for it, that description shows verbatim. If not, Verinode composes one from the program's settings: the enrollment model in plain words ("Mandatory enrollment," "Opt-in enrollment," or "Approved-party list"), the audit cadence ("Continuous," "Monthly," "Quarterly," "Annual," or "Event Driven" audit cadence), the external partner kind when one is set (for example, a carrier program naming the kind of external partner it tracks), and the effective date window when the program has one, shown as a single date or a start-to-end range.

Three secondary figures, laid out beside the headline:

• The same metric as the headline (qualified parties, or active enrollments), with a sub-line showing how many of those are on probation.
• Open violations, the count of unresolved violations across every party or franchisee on this program. The sub-line reads the count of critical-severity ones when any exist, "All clear" when the open count is zero, or "Severity mixed" otherwise.
• Audits last 90d, how many audits this program has recorded in the trailing 90 days, with the audit cadence repeated underneath for context.

Each secondary figure carries a color tone: green when the number reflects good standing (active parties, zero violations), amber-toward-red when violations are open, red when any are critical.

How the rows are chosen

Below the hero, Verinode builds the row list once, in this fixed order, adding a row only when it applies to this specific program:

1. Hero (always, described above).
2. Approved parties, only when the enrollment model is approved-party list.
3. Franchisee enrollments, only when the enrollment model is mandatory or opt-in. A program only ever gets one of rows 2 or 3, never both, the enrollment model is a single either/or setting.
4. Audit rubric, only when the program type is vendor approval.
5. KPI threshold matrix, only when the program type is carrier.
6. Network target, shown to admins on every program (so they can declare one), and shown to everyone else only once a target has actually been set.
7. Open violations, only when at least one violation is currently open or escalated.
8. Recent audits, shown to admins always (so the "+ Schedule" affordance stays reachable even with zero audits on file), and shown to everyone else only once at least one audit has been recorded.
9. Latest KPI snapshots, only when at least one KPI reading has been captured for this program.

That is why two programs of different types, or the same type on different enrollment models, can look meaningfully different on this page. A mandatory certification program with no violations and no audits yet will show just the hero and the franchisee-enrollments row to a non-admin viewer. An active carrier program with a KPI matrix configured, open violations, and recent audits will show the hero, enrollments, KPI matrix, network target, violations, audits, and KPI snapshots, seven rows deep.

Approved parties row

Appears for approved-party-list programs: vendor approval, carrier, or TPA programs set up to track a roster of external parties rather than franchisees.

Each party is a tile showing:

• A qualification-status label: Pending, Qualified, Probation, Suspended, or Removed.
• The party's display name as the headline.
• A sub-line naming the party kind (Vendor, Carrier, TPA, Certification body, Lab, or Broker), plus the last audit score out of 100 when one is on file.
• A meta line showing whichever is most relevant: for a vendor party with a negotiated rate on file, "Negotiated $X/mo" (and a tolerance percent when set); otherwise the next audit due date, or the last audit date, or the date the party was first qualified, whichever is available.

Click a vendor party as an admin and a modal opens to set or clear its negotiated monthly rate and tolerance percent. That number is not cosmetic: it feeds the rate-drift signal on the Vendors page, when the network's median per-franchisee spend with that vendor drifts past the negotiated rate by more than the tolerance band, the vendor surfaces there as a renegotiation candidate. Default tolerance is 10%, wide enough to absorb ordinary regional variance without flagging every small difference.

Empty state (non-admin): "No parties qualified yet. Approved vendors / carriers / labs appear here once the program owner walks them through the audit rubric and grants qualified status."

Admin-only affordance: a "+ Add the first party" tile (or "+ Add party" once the list is non-empty) opens a modal to add a vendor, carrier, TPA, cert body, lab, or broker, set its starting qualification status (Pending, Qualified, or Probation), an optional qualified-until date, and notes.

Franchisee enrollments row

Appears for mandatory or opt-in programs: cert mandate, training, brand standard, or safety programs that attach franchisees rather than external parties.

Each enrolled franchisee is a tile showing:

• A status label: Mandatory, Enrolled, Probation, Decertified, or Withdrawn.
• The franchisee's location name as the headline.
• A sub-line: if the franchisee has open violations, the count of them plus the last audit score when available; otherwise the last audit score with "No open violations," or just "No open violations" if there is no audit score yet.
• A meta line showing when the franchisee enrolled, relative to today ("3 months ago"), and how they enrolled when that is known (for example, self-attached versus auto-attached).

Empty state differs by enrollment model:

• Mandatory: "No franchisees enrolled yet. Mandatory enrollment auto-attaches every operator in the network once the program is activated."
• Opt-in: "No franchisees enrolled yet. Opt-in enrollment waits for operators to self-attach from their IQ programs section."

This row has no admin add-affordance: enrollment happens automatically (mandatory programs) or by franchisee self-attach (opt-in programs), not by an HQ admin manually adding a franchisee.

Audit rubric row

Only on vendor approval programs. This is where the network's audit criteria live: the weighted checklist an auditor works through when qualifying or re-certifying an approved party.

When criteria exist, each one is a tile showing its weight, its label, and its max points. A trailing "Edit rubric" tile (admin only) shows the criterion count and the pass threshold percent.

Empty state (non-admin): "No rubric defined yet. Group admin can author the weighted criteria + max points + pass threshold from this row."

Admin editing: opens a modal to add up to 80 weighted criteria, each with a label, a weight, and a max-points value, plus a single pass-threshold percent applied against the total possible points across every criterion. The modal live-calculates the points needed to pass as you adjust the threshold. An optional description field carries interpretation guidance to whoever conducts the audit.

KPI threshold matrix row

Only on carrier programs. Four fixed KPI metrics are available: Cycle time (days, lower is better), First contact (hours, lower is better), Billing accuracy (%, higher is better), and Customer satisfaction (%, higher is better). Each one can be enabled independently.

When at least one metric is configured, each shows as a tile with its direction ("↑ better" or "↓ better"), its label, and its green/amber band values. A tile is tagged AUTO-DECERTIFY when a red-band reading on that metric is set to auto-flip the carrier to probation, or REVIEW when red readings instead route to manual review.

Empty state (non-admin): "KPI thresholds not defined yet. Group admin can author the red / amber / green bands per metric from this row."

Admin editing: a modal listing all four metrics with a checkbox to enable each, and green-at / amber-at number inputs plus an auto-decertify toggle for each enabled metric. Verinode enforces that green and amber stay on the correct side of each other for the metric's direction (for example, on cycle time, green must be less than or equal to amber, since lower is better there).

Network target row

Shown on every program to admins (so they can declare or clear a target), and shown to non-admins only once a target is actually set. This is a network-wide compliance target the program declares against one metric drawn from five sections: Facilities, Fleet, Equipment, Commercial, or Reputation (things like average vehicle age, equipment in-service percent, commercial collected percent, Google rating, and similar per-section metrics).

Once set, the tile shows the target as a threshold ("≥ 4.5" or "≤ 21 days," for example) with the metric's plain-language label underneath, and a meta line stating the direction in words: "Franchisees meet at or above" or "Franchisees meet at or below." When the target carries grace days, those show alongside the metric label, the number of days a newly-enrolled franchisee gets before compliance on this metric is evaluated at all.

Setting a target here is what makes a ✓ Meets target / ✗ Below target tag appear on the matching metric tile on every franchisee's own section slider (Facilities, Fleet, Equipment, Commercial, or Reputation) elsewhere in HQ. If two active programs in the network ever target the same metric, the one activated most recently takes precedence.

Empty state (non-admin): "No network target declared. Group admin can pick a metric + value from this row."

Admin editing: a modal to pick a metric (grouped by section in the dropdown), a target value in that metric's own units, a direction ("Higher meets" or "Lower meets"), and grace days. A Clear target option removes it entirely, which also removes the compliance tags from every franchisee's slider tile.

Open violations row

Appears only when the program has at least one violation currently in open or escalated state (resolved and waived violations are not shown here). Each violation is a tile, rendered with an action framing to draw the eye, showing:

• A severity-and-escalation label: for example "Critical · Open" or "High · Escalated."
• The violation's reason, as the headline.
• A sub-line naming the subject (the franchisee or approved party the violation is against) and how it was detected: audit, signal, manual, or KPI threshold.
• A meta line showing when it was detected, relative to today.

There is no admin action on this row today, it is a read-only view onto violations that get created elsewhere (through an audit result, a KPI-threshold breach, an automated signal, or manual entry).

Recent audits row

Shown to admins on every program (so the + Schedule tile stays reachable even with an empty audit history), and shown to non-admins only once at least one audit has been recorded. Each audit is a tile showing:

• The audit type and status together: for example "Annual · Approved" or "Spot · Disputed." Audit types are Annual, Quarterly, Spot, Triggered (signal-driven), or Self-attest (operator-submitted). Statuses run Draft → Submitted → Approved, or Disputed / Withdrawn.
• The subject (franchisee or approved party) as the headline.
• A sub-line: the score out of 100 plus a findings excerpt when both exist, just the findings excerpt when there's no score yet, or the auditor kind when neither is available.
• A meta line showing when it was conducted, relative to today.

Admin-only affordance: a "+ Schedule" tile opens a modal to create a draft audit: pick the subject (an approved party or an enrolled franchisee, depending on the program's enrollment model), the audit type, a scheduled date, and optional initial findings. If there are no eligible subjects yet, the modal explains why (add an approved party first, or wait for enrollments to warm up) instead of letting you schedule against nothing.

Latest KPI snapshots row

Appears only when at least one KPI reading has been captured for this program. Each snapshot is a tile showing the KPI name, its value (formatted as a whole number or to two decimals depending on the metric), a sub-line naming the subject and the period the reading covers, and a meta line for when it was captured, relative to today.

There is no admin action to add a KPI snapshot from this row directly, readings are captured through the program's underlying data flow rather than typed in here.

What only admins can do here

Everything on this page is visible to any HQ user with access to Programs. The authoring affordances, adding an approved party, scheduling an audit, editing the rubric, editing the KPI matrix, setting the network target, and setting a vendor's negotiated rate, are admin-only. A non-admin viewer sees the same rows and the same data, just without the "+" tiles and edit affordances, and with a short explanatory sentence in place of each one.

Quick reference: what makes each row disappear

| Row | Shows for | Disappears when | |---|---|---| | Approved parties | Enrollment model = approved-party list | Enrollment model is mandatory or opt-in | | Franchisee enrollments | Enrollment model = mandatory or opt-in | Enrollment model is approved-party list | | Audit rubric | Program type = vendor approval | Any other program type | | KPI threshold matrix | Program type = carrier | Any other program type | | Network target | Admins always; non-admins once set | Non-admin viewer with no target set | | Open violations | At least one open or escalated violation | Zero open/escalated violations | | Recent audits | Admins always; non-admins once one exists | Non-admin viewer with zero audits | | Latest KPI snapshots | At least one snapshot captured | Zero snapshots captured |

Related help articles

• hq-programs, the Programs catalog page this detail view is opened from.
• hq-programs-type-filter-tabs, how the catalog's type tabs narrow what you see before you click into a program.
• hq-standards, the dedicated surface for brand-standard and certification-style programs as it comes online.
• hq-vendors-detail-programs-participation, how a vendor's program participation rolls up on its own detail page.
• hq-vendors-rate-drift, how a negotiated rate set on an approved party feeds the rate-drift signal.
• hq-compliance, the network-wide compliance rollup that open violations and audit results feed into.
• hq-facilities-program-targets, a worked example of a network target's compliance tag appearing on a franchisee's Facilities slider.