Documentation

Managing vCABs

vCAB
Updated Dec 01, 2025

Creating a vCAB

Required Information

Field Description
Name Descriptive name (e.g., Security Review Board)
Description Purpose and scope of the vCAB
Approval Type Unanimous, Majority, or Quorum
Members Users who will vote on changes

Optional Settings

Field Description
Quorum Count Required approvals (only for Quorum type)
Chair Can Veto Enable chair veto power
Chair Can Break Ties Enable chair veto power
Require All Mandatory Block decisions until mandatory members vote

Member Configuration

For each member, configure:
  1. Member Type - Chair or Voting
  2. Mandatory - Whether their vote is required
  3. Approval Role - Optional display tag

Best Practices

  • One chair per vCAB - Multiple chairs can cause confusion
  • Odd number of voting members - Reduces tie scenarios
  • Mark key stakeholders as mandatory - Ensures critical input

Editing a vCAB

What Can Be Changed and the effect

Setting Effect on Pending Changes
Name/Description No effect
Approval Type
Applies to new changes only
Quorum Count
Applies to new changes only
Chair Powers
Applies immediately to all changes associated
Add Member
New member doesn't affect pending changes
Remove Member
Removed member's votes still count
Change Member Type
Applies to new changes only

 Why This Matters

  • Consistency - Changes are evaluated by original reviewers
  • Audit Trail - Vote history is preserved
  • No Gaming - Can't add/remove members to influence outcome

Archiving a vCAB

Archiving a vCAB:
  • Sets is_active = False
  • vCAB no longer appears in selection lists
  • Cannot be used for new changes
  • Existing changes continue to completion
  • Historical data preserved

Approval Roles

Approval roles are optional tags that help identify member expertise.

Creating Roles

Roles are created per-company and can include:
  • Name - e.g., "Security Lead", "Architecture"
  • Description - Role responsibilities
  • Color - Visual identifier

Using Roles

Roles appear:
  • In the vCAB member list
  • On vote status displays
  • In approval notifications

Example Roles

Role Color Description
Security Lead Red Reviews security implications
Architecture Blue Evaluates technical design
Operations Green Assesses operational impact
Compliance Purple Ensures regulatory compliance

 Troubleshooting

Votes disappeared after editing vCAB:
This was a bug that has been fixed. Editing a vCAB now preserves all vote records. If you experience this:
 
New member can't vote on existing change:
By design. New members only vote on changes submitted after they joined. For existing changes:
  1. The change continues with original voters
  2. Or resubmit the change to get new vote records
Decision not being made despite enough votes:
Check for:
  1. Mandatory members - Have all mandatory members voted?
  2. Approval type - Is the threshold actually met?
  3. Chair tie-break - Is it a tie requiring chair decision?
Previous

No previous article

Next

vCAB Approval Types