Overview

Issues in FixTraq are automatically created when inspection questions fail, helping you track and resolve problems discovered during facility inspections. Each issue captures the failure reason, location, severity, and related inspection details, providing a complete audit trail from discovery to resolution.

What are Issues?

Issues represent problems or non-compliance items found during inspections. They are:

• Automatically Created: Generated when inspection questions are answered with a "fail" status
• Linked to Inspections: Every issue ties back to a specific inspection and question
• Trackable: Includes status, severity, assignment, and complete change history
• Collaborative: Can be assigned to team members with notes and media attachments

Issue Statuses

Issues progress through various statuses during their lifecycle:

• Open: Newly created issue requiring attention
• In Progress: Someone is actively working on resolving the issue
• Resolved: Issue has been fixed and closed successfully
• Closed: Issue archived or completed
• Reopened: Previously resolved issue that needs attention again

Severity Levels

Each issue has a severity rating that helps prioritize work:

• Low: Minor issues that can be addressed during routine maintenance
• Medium: Standard issues requiring timely attention (default)
• High: Significant issues that should be resolved promptly
• Critical: Urgent safety or compliance issues needing immediate action

Viewing Issues

Issues Dashboard

Access all issues from the main Issues page at [/issues](/issues). The dashboard displays:

1. Statistics Cards: Quick overview of open, in-progress, resolved, critical issues, and 30-day trends
2. Filter Controls: Search and filter options to find specific issues
3. Issues List: Paginated list showing all issues with key details

Each issue card shows:

• Question text and failure reason
• Current status and severity badges
• Location and creation date
• Assigned team member (if applicable)
• Quick access to view full details

Filtering and Searching

Use the powerful filtering system to find issues quickly:

Search

Type keywords in the search bar to find issues by:

• Question text
• Failure reason
• Notes
• Location

Filter by Status

Select one or multiple statuses to view:

• All Issues
• Open
• In Progress
• Resolved
• Closed
• Reopened

Filter by Severity

Choose severity levels:

• All Severities
• Low
• Medium
• High
• Critical

Additional Filters

- **Date Range**: Filter issues created within specific dates - **Location**: Find issues from particular facility areas - **Assigned User**: View issues assigned to specific team members - **Inspection**: See all issues from a particular inspection

Sorting Options

Sort issues by:

• Created Date (newest/oldest)
• Last Modified (most recently updated)
• Severity (highest/lowest priority)
• Status (by workflow stage)
• Location (alphabetically)

Viewing Issue Details

Click "View Details" on any issue to see:

Overview Section

- Full question text and context - Detailed failure reason - Location and timing information - Resolution notes (if resolved)

Media Attachments

- Photos captured during inspection - Documents and PDFs - Video evidence - Files uploaded during resolution

Related Information

- Link to parent inspection - Other issues from same inspection - Section and question identifiers

Understanding Issue Metadata

Each issue includes:

• Issue ID: Unique identifier for tracking
• Question ID: Links to template question
• Section: Which inspection section contained the failed question
• Created Date: When the issue was first discovered
• Due Date: Optional deadline for resolution (if set)
• Resolved Date: When marked complete (if resolved)
• Organization: Isolates issues to your organization's workspace

Pagination and Navigation

The issues list supports pagination for large datasets:

• View 10, 20, or 50 issues per page
• Navigate using page numbers or previous/next buttons
• Total count displays at the top of the list
• Current page range shown in footer ("Showing 1 to 20 of 156 results")

Mobile Access

The issues dashboard is fully responsive:

• Horizontal scrolling for stat cards
• Collapsible filters
• Compact issue cards on small screens
• Touch-friendly buttons and controls
• Tabbed interface for issue details

Best Practices

For Inspection Teams

- Review new issues immediately after completing inspections - Add detailed notes and photos while on-site - Assign issues to appropriate team members before leaving

For Managers

- Check critical and high-severity issues daily - Monitor the 30-day trend to identify recurring problems - Use location filters to focus on specific facilities or areas

For Resolution Teams

- Filter by assigned user to see your tasks - Sort by due date to prioritize urgent work - Update status regularly to keep team informed

Next Steps

- Learn how to [Resolve and Track Issues](../resolving-issues/) for detailed workflow - Understand [Creating Inspections](../../getting-started/first-inspection/) to see how issues are generated - Review [Template Creation](../../templates/create-a-template/) to configure issue severity defaults