PartnerAlly Docs
Compliance Gaps

Updating Gap Status

Learn how to change gap status and document your remediation progress.

Updating Gap Status

Changing a gap's status is how you track remediation progress. This guide covers when and how to update status, including required documentation.

Status Options

Gaps can be in these states:

StatusColorWhen to Use
OpenGrayGap identified, not yet addressed
In ProgressBlueActively being remediated
ResolvedGreenSuccessfully addressed with evidence
AcceptedYellowRisk accepted, won't remediate

Changing Status

Single Gap Update

Open the Gap

Click the gap from the list to open its detail view.

Click the Status Badge

A dropdown menu appears with status options.

Select New Status

Choose the appropriate status from the list.

Add Notes

A modal appears for required documentation. Explain the change.

Save Changes

Click "Update" to apply the new status.

Bulk Status Updates

Update multiple gaps at once:

  1. Select gaps - Check boxes next to gaps in the list
  2. Click "Bulk Actions" - Opens the action menu
  3. Choose "Update Status" - Select the new status
  4. Add notes - Explanation applies to all selected gaps
  5. Confirm - Apply changes

Bulk updates are logged in the audit trail. Be specific in your notes since the same explanation applies to all selected gaps.

Status Transition Rules

Valid Transitions

FromToWhen Appropriate
OpenIn ProgressWork has started
OpenResolvedQuick fix, immediately addressed
OpenAcceptedManagement approved non-remediation
In ProgressResolvedRemediation complete
In ProgressOpenWork paused or needs re-evaluation
In ProgressAcceptedDecision made to accept risk
ResolvedOpenIssue reappeared or not fully fixed
AcceptedOpenRisk tolerance changed

Status Reopening

Gaps can be reopened if:

  • The fix didn't fully address the issue
  • New evidence shows the gap persists
  • Related findings from audits
  • Regulatory changes make previous resolution insufficient

Documentation Requirements

For "In Progress"

Include:

  • Who is working on this
  • What workflow or task addresses it
  • Expected timeline

Example note:

"Assigned to security team. Workflow WF-042 created. Expected completion: 2 weeks."

For "Resolved"

Include:

  • What was done to fix it
  • Link to evidence documents
  • Who verified the fix

Example note:

"Updated Access Control Policy to include quarterly access reviews. See Document DOC-156. Verified by Security Manager."

For "Accepted"

Include:

  • Business justification
  • Who approved the acceptance
  • Compensating controls if any
  • Review date

Example note:

"Accepted by CISO (Jane Smith) on 2024-01-15. Risk is low due to limited data exposure. Compensating control: enhanced monitoring. Review by Q2 2024."

Acceptance documentation is especially important for audits. Auditors expect clear justification and approval for any gaps not remediated.

Linking Evidence When Resolving

When marking a gap as resolved, link supporting evidence:

Click "Add Evidence"

Opens the document selector.

Choose Documents

Select existing documents or upload new ones.

Explain Relevance

Note how each document addresses the gap.

Complete Resolution

Evidence links are saved with the status change.

Good Evidence Practices

Evidence TypeExample
Policy updateRevised policy document with gap coverage
ProcedureNew or updated procedure addressing requirement
ConfigurationScreenshot showing implemented control
Test resultsScan or assessment showing remediation
Sign-offApproval document from management

Status History

Every status change is recorded:

Recorded DataPurpose
Previous statusShows what changed
New statusCurrent state
Who changed itAccountability
When changedTimeline tracking
Notes providedJustification and context

Viewing History

  1. Open the gap detail view
  2. Click the "Activity" tab
  3. See all status changes with full context

Auto-Status Updates

Some status changes happen automatically:

Workflow Completion

When a workflow addressing a gap is completed:

  • Gap can be auto-marked as "In Progress" or "Resolved"
  • Depends on workflow configuration
  • Manual confirmation may be required

Document Re-analysis

When documents are re-analyzed:

  • Previously resolved gaps may reopen if issues persist
  • You're notified of status changes
  • Review and confirm or override

Audit Trail

All status changes are audit-logged:

Logged InformationAudit Value
User identityWho made changes
TimestampWhen changes occurred
Status transitionWhat changed
NotesBusiness context
IP addressSecurity tracking

The audit trail is immutable. You cannot delete or modify historical status changes. This ensures compliance integrity.

Best Practices

Be Timely

  • Update status as soon as work starts
  • Don't leave gaps as "Open" if being addressed
  • Mark resolved immediately when done

Be Accurate

  • Don't mark as resolved without evidence
  • Don't accept gaps without proper approval
  • If uncertain, leave as "In Progress"

Be Detailed

  • Always add meaningful notes
  • Link relevant evidence
  • Reference related items (workflows, tasks)

Be Consistent

  • Use the same terminology across gaps
  • Follow your organization's conventions
  • Train team on status meanings

Common Issues

"I can't change the status"

Check if:

  • You have permission to edit gaps
  • The gap isn't locked (some may require admin)
  • You're not trying an invalid transition

"Status keeps reverting"

This can happen if:

  • Automated workflows override manual changes
  • Re-analysis triggers updates
  • Check Activity tab for explanation

"I made a mistake in status notes"

Notes cannot be edited after saving, but you can:

  • Add a clarifying comment
  • Update status again with correct information
  • Contact admin for audit trail correction (rare)

Next Steps

On this page