> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sensorup.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Issues Overview

> Learn how to create, assign, and track Issues to manage field operations and office inspections and emission follow-ups.

Welcome to **Issues in SensorUp**—your central workspace for coordinating inspection work, tracking emissions-related tasks, and managing field operations and office workflows efficiently. In just a few minutes, you'll create your first Issue, assign it to a technician or office staff member, and track its lifecycle from creation to completion.

<Info>
  **Time Required:** 5–7 minutes\
  **What You'll Learn:**

  * How to create and assign an Issue
  * How to track tasks, comments, and data collection
  * How to collaborate between field operations and the office in real-time
</Info>

<Warning>
  **Common Pitfalls:**

  * Forgetting to assign an Issue—unassigned tickets won't appear in the field app
  * Missing due dates or severity—these help prioritize and schedule field operations and office work effectively
</Warning>

## Your First Steps

<Steps>
  <Step title="Create a New Issue">
    Click the **New Issue** button in the top left corner of Mission Control.

    * Set the **Asset** the Issue relates to
    * Provide a meaningful **title** and **description** (dynamic properties can be used)
    * Choose a **due date** to enforce timely completion
    * Select a **severity** level (Critical, High, Medium, Low) to prioritize
    * **Assign** the Issue to a technician or team

    Each created Issue will appear in the main list for tracking and management.

    <img src="https://mintcdn.com/sensorupinc/0xI3jANGft4SN9U2/images/CreateANewIssue.gif?s=ae59b5495426ca3fb0a84ed20bb0060d" alt="Create A New Issue Gi" width="3834" height="1694" data-path="images/CreateANewIssue.gif" />
  </Step>

  <Step title="Review and Manage Issue Details">
    Clicking on any Issue in the list opens its detailed view:

    * See the linked **Asset** and its metadata
    * View and manage **instructions, tasks, and results**
    * Use the **search and filter** tools to refine your view—filters are saved per user
    * Monitor **modified data** streamed from field operations and office work in near real-time
    * Add **comments** to coordinate with others

          <img src="https://mintcdn.com/sensorupinc/0xI3jANGft4SN9U2/images/OpenIssueDetails.gif?s=ed3679f18d655c7a2547e32501fe35cc" alt="Open Issue Details Gi" width="3834" height="1694" data-path="images/OpenIssueDetails.gif" />
  </Step>

  <Step title="Field Technician Responds via Outpost">
    Assigned Issues appear in the **Outpost mobile app**.\
    Technicians will:

    * Complete a **Site Check-In form**
    * Record results using **mobile forms** (including photos, geotags, severity, H₂S, etc.)
    * Update the status to **In Progress** and complete tasks
    * Add **comments** if needed for field-to-office communication
  </Step>

  <Step title="Track, Review, and Close the Issue">
    As the technician works, the Issue progresses:

    * **Open** → **In Progress** → **Done**
    * Field data is streamed live (or synced when back online)
    * Office staff can **review, validate, or edit** data
    * Once everything is confirmed, **mark the Issue as Closed**

    <Check>
      **You Did It!**\
      ✅ Created and assigned your first Issue\
      ✅ Tracked live progress and validated data from field operations and office work\
      ✅ Closed the Issue with full traceability
    </Check>
  </Step>
</Steps>

## Key Concepts Recap

<Info>
  ✅ **Issue (Ticket):** Structured task related to an Asset\
  ✅ **Lifecycle:** Open → In Progress → Done/Closed\
  ✅ **Asset Link:** Every Issue is tied to a site or equipment\
  ✅ **Collaboration:** Shared comments, data, and attachments across devices\
  ✅ **Visibility:** Accessible from web and mobile (SensorUp + Outpost)
</Info>

## Additional Functionality

### Task and Procedure Tracking

Each Issue may include multiple **tasks or results** related to one site visit:

* Each task has a **lifecycle**: Open → In Progress → Done
* Task **status and details** can be viewed and edited by specialists in Mission Control
* All data collected is editable (except raw observation context)

### Comments and Communication

Use the **comments section** to:

* Capture unstructured insights from field operations and office work
* Communicate in real-time across teams
* All comments are instantly visible to users with access to that Issue

<img src="https://mintcdn.com/sensorupinc/0xI3jANGft4SN9U2/images/AddingaCommenttoIssues.gif?s=915ad34425c9e5a9d3685ba749b2c9cb" alt="Addinga Commentto Issues Gi" width="3834" height="1694" data-path="images/AddingaCommenttoIssues.gif" />

### Reopening and Reassignment

Closed Issues can be **reopened** by administrators in Mission Control:

* Reopened Issues are automatically **re-assigned** to the original user
* The Issue appears again in their mobile app for updates or corrections

### Deleting Issues

Users with delete permissions can remove Issues that are no longer needed.

To delete an Issue:

1. Open the Issue detail view
2. Click the **actions menu** (three dots icon) in the header
3. Select **Delete**
4. Review the confirmation dialog—it will display the Issue name and confirm that assets and statuses will not be affected
5. Click **Delete** to confirm

<Info>
  If you are deleting an Issue created by another user, the confirmation dialog will show the creator's name and their group (if different from yours).
</Info>

<Info>
  The actions menu is only visible if you have manage permissions. If the delete option is disabled, hover over it to see the reason.
</Info>

### Bulk Deleting Issues

You can select and delete multiple Issues at once from either the Issues list view or the Issues Map view.

To bulk delete Issues:

1. Select the Issues you want to delete by clicking the checkboxes next to each Issue in the list view, or by selecting markers in the Map view
2. A floating action bar appears at the bottom of the screen, showing the number of selected Issues
3. Click **Delete** in the floating action bar
4. Review the confirmation modal, which displays the total count of Issues to be deleted
5. Click **Delete** to confirm and start the bulk deletion job

<Info>
  The bulk delete option is only available to users with delete permissions. Viewers will not see the selection controls or the floating action bar.
</Info>

<Info>
  If some of the selected Issues cannot be deleted, a modal will explain the reasons why those Issues are excluded from the bulk operation.
</Info>

<Note>
  Sub-tasks belonging to deleted Issues are not automatically removed. You will need to manage sub-tasks separately if needed.
</Note>

## Permissions

Access to Issues is controlled by user roles. Understanding your role helps you know what actions you can take:

| Role              | Permissions                                                                                       |
| ----------------- | ------------------------------------------------------------------------------------------------- |
| **Viewer**        | View all Issues from groups they have access to, but cannot create, modify, or delete             |
| **Editor**        | View, create, and update Issues from groups they have access to; can only delete their own Issues |
| **Administrator** | View, create, update, and delete all Issues from groups they have access to                       |
| **Super Admin**   | View, create, update, and delete all Issues                                                       |

<Info>
  **Need more details?** See [User Roles and Permissions](/use-sensorup/user-management/User-roles-permissions) for complete information about role-based access control across all SensorUp features.
</Info>

## What's Next?

Now that you've created and completed your first Issue, you're ready to use advanced tools like triggered inspections, alarms, and multi-task workflows.

<CardGroup cols={2}>
  <Card title="Creating OGI Inspection Issues" icon="search" href="/use-sensorup/connected-operations/issue-management/creating-ogi-inspection">
    Learn how to trigger and manage optical gas imaging inspections.
  </Card>

  <Card title="Tasks" icon="clipboard-check" href="/use-sensorup/field-operations/tasks/overview">
    Learn how to create and manage tasks within issues.
  </Card>

  <Card title="Forms" icon="file-lines" href="/use-sensorup/field-operations/forms/overview">
    Design form templates for tasks.
  </Card>

  <Card title="Results" icon="reply" href="/use-sensorup/field-operations/results/overview">
    Review data from completed tasks.
  </Card>

  <Card title="Outpost Mobile" icon="mobile-screen-button" href="/use-sensorup/outpost-mobile/overview">
    Complete tasks on mobile devices.
  </Card>
</CardGroup>
