The evidence pipeline
Every piece of evidence moves through the same lifecycle: Upload → Link to a control → Validate (owner or admin) → Effective maturity updates → Risk score recalculates Evidence that is uploaded but not linked to a control has no effect on your score. Evidence that is linked but not yet validated is counted as pending. Only accepted or accepted with gaps evidence contributes to your effective maturity.Coverage metrics
Four metric tiles appear at the top of the Evidence page:- Controls covered — how many controls have at least one linked evidence item, out of your total control count
- Validated — the number of evidence items with accepted status
- Needs review — items that are linked to a control and awaiting validation by an owner or admin
- Action required — the sum of expired items, controls missing required evidence, and rejected items
Tabs on the Evidence page
- Evidence library
- Review queue
- Requests
- Auto-collected
The main view showing all your uploaded evidence items. Use the filter pills — Unlinked, Pending, Expiring, Validated, Rejected — to focus on a specific subset. You can also filter by tag if you’ve created evidence tags.
Uploading evidence
Open the upload modal
Click Upload Evidence in the top-right corner of the Evidence page. The same button appears in the empty state if you haven’t uploaded anything yet.
Fill in the details
Give the item a clear title and an optional description. Select the evidence type — Screenshot, PDF, Policy, Audit Report, Log Export, Config Export, Attestation, or Other.
Attach a file or note the source
Upload a file directly, or add a URL or reference if the document is stored elsewhere.
Linking evidence to a control
After uploading, link the evidence item to one or more controls so it can contribute to your posture score.Find the evidence item
Locate the item in the Evidence Library. Items that are not yet linked to any control show a note: “Not linked to any control — use Link to attach.”
Click Link
Click the Link button on the right side of the item row. A selector appears showing all your controls.
Choose controls
Select the controls this evidence supports. A single evidence item can be linked to multiple controls — this is called a shared item and is labeled Shared in the library.
Only owners and admins can validate (accept or reject) evidence. If you are a member without that role, your linked items wait in the queue until an admin reviews them.
Understanding expiry dates
Evidence items can have an expiry date. As expiry approaches, the following signals appear:| State | Display |
|---|---|
| Fresh | No expiry badge |
| Expiring within 30 days | Amber “Xd left” badge |
| Expired | Red “Expired” badge |
Downloading an evidence certificate
An evidence certificate is a downloadable PDF that records a specific control’s evidence status — useful for auditor handoffs or internal review cycles. To download a certificate, open the controls evidence drawer from the Controls page, then use the Download Certificate option from the action menu on any validated evidence item. Evidence certificates are also available through the API at/api/reports/evidence-certificate.