Resolve Issues with Comments and Attachments

Administrators can require team members to provide comments and/or attachments when marking issues as resolved. This ensures proper documentation, accountability, and audit trails for issue resolutions.

Configuration Modes

Admins can choose from three modes in Settings → General Settings → Issue Tracker Settings → “Resolve issue with comments”:

Admin Settings Navigation

Feature Settings

ModeCommentAttachmentBest For
No Requirements (Default)--Quick resolutions, low-risk issues
Comment RequiredRequired (10-250 chars Admin, 1+ char Mobile)Optional (up to 10)Process issues needing explanation
Comment + Attachment RequiredRequiredRequired (1-10 files)Safety, quality, compliance issues requiring proof

Changes apply immediately across both Admin and Mobile apps.

How to Resolve Issues

Admin Web Application

The resolution modal appears when changing status to “Resolved” in any of these locations:

  • Table View: Status dropdown
  • Kanban View: Drag to “Resolved” column or status dropdown
  • List View: Status button in details panel
  • Issue Details Page: Status button in header
  • Bulk Edit: Select multiple issues → Bulk Actions → Edit → Change status

Note: In bulk edit, the same comment and attachments apply to all selected issues.

Auditor Mobile App

Resolve issues from:

  • Quick Resolve Button: Tap “Resolve This Issue” at bottom of issue details
  • Status Dropdown: Details tab → Status field → Select “Resolved”
  • Bulk Edit: Long-press to select multiple → Edit icon → Change status → “Update Issues”

Note: In bulk edit, one comment and attachments apply to all selected issues.

Resolution Modal Fields

Admin Web Application

Comment with Optional Attachment:

Admin Modal - Optional Attachment

Comment with Required Attachment:

Admin Modal - Required Attachment

Comment Input:

  • Admin App: 10-250 characters required
  • Mobile App: 1-250 characters required (with live counter, @mentions support)

Attachments:

  • Optional mode: 0-10 files allowed
  • Required mode: 1-10 files minimum
  • Admin App: Images (.gif, .jpg, .jpeg, .png), Documents (.pdf, .doc, .docx, .xls, .xlsx, .csv), Videos (.mp4, .mov, .avi), 7 MB max per file
  • Mobile App: Photos, Documents, Videos via Camera, Gallery, Document Picker, or Video Recorder

Submit Button: Disabled until all required fields are completed and uploads finish.

Auditor Mobile App

Comment with Optional Attachment:

Mobile Modal - Optional Attachment

Comment with Required Attachment:

Mobile Modal - Required Attachment

Validation Rules

Comments:

  • Admin: 10-250 characters
  • Mobile: 1-250 characters
  • Errors shown for too short/long entries

Attachments:

  • Optional: 0-10 files
  • Required: 1-10 files minimum
  • Unsupported formats rejected with error
  • File size limits enforced

Example Workflow

Scenario: Organization requires comment + 1 attachment

  1. User taps “Resolve This Issue”
  2. Confirms resolution in alert
  3. Modal opens: “Please provide details about the resolution”
  4. User enters comment: “Replaced the rubber seal on the freezer door. Tested multiple times - now sealing properly.” (84/250 characters)
  5. Submit button stays disabled until attachment added
  6. User adds photo via camera
  7. Photo uploads successfully
  8. Submit button becomes enabled
  9. User taps “Submit”
  10. Issue status changes to “Resolved” with documented evidence

Additional Information

Languages: Available in English, Spanish, Indonesian, Khmer, Korean, Portuguese, Thai

Other Status Changes: The “Blocked” status always requires a comment. Other statuses don’t require comments or attachments.

Platforms: Works across Admin Web Application and Auditor Mobile App