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

# Events on mobile

> Filter, acknowledge, and investigate FDD events and incidents from the KODE OS mobile app.

Use `FDD Events` for real-time triage while you are on site. An **event** is one FDD finding on a device. An **incident** groups related events under one ID so you can see shared impact. Events match [Events](/products/fdd/events) on the web.

## Triage an event

<Steps>
  <Step title="Open FDD Events">
    Select `FDD Events` from the building app launcher.
  </Step>

  <Step title="Narrow the list">
    Tap the header `filter` icon for area, priority, and date chips such as `Last 7 Days`. Use the `history` icon to refresh when streaming is enabled for your site.
  </Step>

  <Step title="Open a row">
    Tap an event for a quick summary sheet, then `Event Details` for the full page.
  </Step>

  <Step title="Acknowledge and investigate">
    Acknowledge when you are assigned. Use `Points Trend` to see sensor history, add comments, or create a work order when needed.
  </Step>
</Steps>

## Choose a view

The header dropdown switches list and dashboard modes:

<div className="flex justify-center w-full my-4">
  <Frame className="w-fit mx-auto" caption="Events, Incidents, Active, and Historical">
    <img className="mx-auto block h-auto max-w-[400px] w-full" src="https://mintcdn.com/kodelabs/IXjGUtCN1G_ZdIHf/images/mobile-app/kode-os-mobile-fdd-events-view-menu.png?fit=max&auto=format&n=IXjGUtCN1G_ZdIHf&q=85&s=1fe95070d7efda27b26a0c517194c878" alt="FDD Events view menu with Events, Incidents, Active, and Historical options" width="400" height="868" data-path="images/mobile-app/kode-os-mobile-fdd-events-view-menu.png" />
  </Frame>
</div>

| Mode         | Purpose                                                                                                                  |
| ------------ | ------------------------------------------------------------------------------------------------------------------------ |
| `Events`     | Individual FDD findings                                                                                                  |
| `Incidents`  | Grouped events by incident ID                                                                                            |
| `Active`     | Open items with KPI cards—see [Event dashboards](/products/mobile-app/events/customize-event-dashboard#active-dashboard) |
| `Historical` | Closed or past items with analytics cards                                                                                |

On the list screen, switch between `Events` and `Incidents` with the tabs under the header.

<div className="flex justify-center w-full my-4">
  <Frame className="w-fit mx-auto" caption="Events and Incidents tabs">
    <img className="mx-auto block h-auto max-w-[400px] w-full" src="https://mintcdn.com/kodelabs/IXjGUtCN1G_ZdIHf/images/mobile-app/kode-os-mobile-fdd-events-incidents-tabs.png?fit=max&auto=format&n=IXjGUtCN1G_ZdIHf&q=85&s=3b6c86ce2fb7cc92c7240d6bd1924704" alt="FDD Events list tabs with Events selected and Incidents unselected" width="201" height="64" data-path="images/mobile-app/kode-os-mobile-fdd-events-incidents-tabs.png" />
  </Frame>
</div>

<Tabs>
  <Tab title="Events">
    <div className="flex justify-center w-full my-4">
      <Frame className="w-fit mx-auto">
        <img className="mx-auto block h-auto max-w-[400px] w-full" src="https://mintcdn.com/kodelabs/IXjGUtCN1G_ZdIHf/images/mobile-app/kode-os-mobile-fdd-events-list.png?fit=max&auto=format&n=IXjGUtCN1G_ZdIHf&q=85&s=dd7c3a60f3fc6f23979688e6a5965d9d" alt="FDD Events list with Damper Fully Open and Temperature Greater than Setpoint alerts on VAV devices" width="400" height="868" data-path="images/mobile-app/kode-os-mobile-fdd-events-list.png" />
      </Frame>
    </div>

    Each row shows:

    | Element       | Description                                                    |
    | ------------- | -------------------------------------------------------------- |
    | Routine title | Fault name (for example, `Damper Fully Open for Long Periods`) |
    | Alert badge   | Priority such as `Alert`                                       |
    | Status        | `Active` or duration (for example, `5 minutes`)                |
    | Device link   | Equipment path such as `VAV_303`                               |

    Tap a row to open a quick summary sheet, then `Event Details`.

    <div className="flex justify-center w-full my-4">
      <Frame className="w-fit mx-auto" caption="Event summary sheet">
        <img className="mx-auto block h-auto max-w-[400px] w-full" src="https://mintcdn.com/kodelabs/IXjGUtCN1G_ZdIHf/images/mobile-app/kode-os-mobile-fdd-event-detail-sheet.png?fit=max&auto=format&n=IXjGUtCN1G_ZdIHf&q=85&s=20b1709c8b4056787737f7724a785737" alt="Event sheet with area Floor 1, Occupancy command point, and Active end time" width="400" height="868" data-path="images/mobile-app/kode-os-mobile-fdd-event-detail-sheet.png" />
      </Frame>
    </div>

    ### Event details

    <span id="event-details" />

    The full event page includes metadata, diagnostics, and actions.

    <div className="flex justify-center w-full my-4">
      <Frame className="w-fit mx-auto">
        <img className="mx-auto block h-auto max-w-[400px] w-full" src="https://mintcdn.com/kodelabs/IXjGUtCN1G_ZdIHf/images/mobile-app/kode-os-mobile-event-detail.png?fit=max&auto=format&n=IXjGUtCN1G_ZdIHf&q=85&s=a67b1ff6286f37d1af881f479e221b6b" alt="Event details with building, device VAV_303, priority Alert, and Unacknowledged control" width="400" height="868" data-path="images/mobile-app/kode-os-mobile-event-detail.png" />
      </Frame>
    </div>

    Use the **section** dropdown below the event title to switch panels.

    <AccordionGroup>
      <Accordion title="Info">
        Shows status, duration, and the routine description (`Show more` expands the full text).

        <div className="flex justify-center w-full my-4">
          <Frame className="w-fit mx-auto" caption="Info tab with description">
            <img className="mx-auto block h-auto max-w-[400px] w-full" src="https://mintcdn.com/kodelabs/IXjGUtCN1G_ZdIHf/images/mobile-app/kode-os-mobile-fdd-event-detail-info.png?fit=max&auto=format&n=IXjGUtCN1G_ZdIHf&q=85&s=9f41d4039406c70995b0b1e19354000b" alt="Event info with Open status, duration, and routine description Show more" width="400" height="868" data-path="images/mobile-app/kode-os-mobile-fdd-event-detail-info.png" />
          </Frame>
        </div>
      </Accordion>

      <Accordion title="Points Trend">
        Select points on the device, then open `Trends View` to compare commands and sensors over time.

        <div className="flex justify-center w-full my-4">
          <Frame className="w-fit mx-auto">
            <img className="mx-auto block h-auto max-w-[400px] w-full" src="https://mintcdn.com/kodelabs/IXjGUtCN1G_ZdIHf/images/mobile-app/kode-os-mobile-fdd-event-points-trend.png?fit=max&auto=format&n=IXjGUtCN1G_ZdIHf&q=85&s=c222a9b1d9fba700a14afd0acd4cf649" alt="Points Trend for VAV_303 with discharge damper percent selected" width="400" height="868" data-path="images/mobile-app/kode-os-mobile-fdd-event-points-trend.png" />
          </Frame>
        </div>

        <div className="flex justify-center w-full my-4">
          <Frame className="w-fit mx-auto" caption="Trends for damper command and occupancy">
            <img className="mx-auto block h-auto max-w-[400px] w-full" src="https://mintcdn.com/kodelabs/IXjGUtCN1G_ZdIHf/images/mobile-app/kode-os-mobile-fdd-event-trends-view.png?fit=max&auto=format&n=IXjGUtCN1G_ZdIHf&q=85&s=4030520936824879c96e2c6c32d4eccb" alt="Trends View for VAV_303 discharge damper percent and occupancy command" width="400" height="868" data-path="images/mobile-app/kode-os-mobile-fdd-event-trends-view.png" />
          </Frame>
        </div>
      </Accordion>

      <Accordion title="Work Orders">
        <span id="work-orders-and-comments" />

        Lists work orders linked to the event. Tap `Create Work Order` to open the create form when none exist yet.

        <div className="flex justify-center w-full my-4">
          <Frame className="w-fit mx-auto">
            <img className="mx-auto block h-auto max-w-[400px] w-full" src="https://mintcdn.com/kodelabs/IXjGUtCN1G_ZdIHf/images/mobile-app/kode-os-mobile-fdd-event-work-orders.png?fit=max&auto=format&n=IXjGUtCN1G_ZdIHf&q=85&s=a36639bd34233cc528215fc0463d1044" alt="Event Work Orders empty state with Create Work Order button" width="400" height="868" data-path="images/mobile-app/kode-os-mobile-fdd-event-work-orders.png" />
          </Frame>
        </div>

        <div className="flex justify-center w-full my-4">
          <Frame className="w-fit mx-auto">
            <img className="mx-auto block h-auto max-w-[400px] w-full" src="https://mintcdn.com/kodelabs/IXjGUtCN1G_ZdIHf/images/mobile-app/kode-os-mobile-fdd-event-create-work-order.png?fit=max&auto=format&n=IXjGUtCN1G_ZdIHf&q=85&s=d74c89ab95a6ab8099d1e01695289bcf" alt="Create Work Order form with Name, Data Source, Entity, and Action fields" width="400" height="868" data-path="images/mobile-app/kode-os-mobile-fdd-event-create-work-order.png" />
          </Frame>
        </div>
      </Accordion>

      <Accordion title="Comments">
        Add notes for your team in the comment thread.

        <div className="flex justify-center w-full my-4">
          <Frame className="w-fit mx-auto">
            <img className="mx-auto block h-auto max-w-[400px] w-full" src="https://mintcdn.com/kodelabs/IXjGUtCN1G_ZdIHf/images/mobile-app/kode-os-mobile-fdd-event-comments.png?fit=max&auto=format&n=IXjGUtCN1G_ZdIHf&q=85&s=bbe0cd74338f5be6b5fd43df23fe066c" alt="Event Comments with Enter comment here field" width="400" height="868" data-path="images/mobile-app/kode-os-mobile-fdd-event-comments.png" />
          </Frame>
        </div>
      </Accordion>

      <Accordion title="Historical">
        Lists past occurrences of the same routine on the device.

        <div className="flex justify-center w-full my-4">
          <Frame className="w-fit mx-auto">
            <img className="mx-auto block h-auto max-w-[400px] w-full" src="https://mintcdn.com/kodelabs/IXjGUtCN1G_ZdIHf/images/mobile-app/kode-os-mobile-fdd-event-occurrences.png?fit=max&auto=format&n=IXjGUtCN1G_ZdIHf&q=85&s=2990a980c302d95f9b838588d5e5cf26" alt="Historical occurrences list for Damper Fully Open with Active and past date ranges" width="400" height="868" data-path="images/mobile-app/kode-os-mobile-fdd-event-occurrences.png" />
          </Frame>
        </div>
      </Accordion>

      <Accordion title="Activity Log">
        Lists system actions such as creation, merges, and notifications with timestamps.

        <div className="flex justify-center w-full my-4">
          <Frame className="w-fit mx-auto" caption="Activity Log with creation timestamp">
            <img className="mx-auto block h-auto max-w-[400px] w-full" src="https://mintcdn.com/kodelabs/IXjGUtCN1G_ZdIHf/images/mobile-app/kode-os-mobile-fdd-event-activity-log.png?fit=max&auto=format&n=IXjGUtCN1G_ZdIHf&q=85&s=2a9f70390f868553c26d1df53abd4401" alt="Event Activity Log showing This event/incident is created with timestamp May 28, 2026 9:11 AM" width="400" height="868" data-path="images/mobile-app/kode-os-mobile-fdd-event-activity-log.png" />
          </Frame>
        </div>
      </Accordion>
    </AccordionGroup>

    Acknowledge events from `Unacknowledged` on the main event page when you are assigned to the event's notification policy. If the control is unavailable, confirm your account or role is listed in the policy `Notify` step.
  </Tab>

  <Tab title="Incidents">
    <span id="incidents-list" />

    <div className="flex justify-center w-full my-4">
      <Frame className="w-fit mx-auto" caption="Incidents list with Last 7 Days filter">
        <img className="mx-auto block h-auto max-w-[400px] w-full" src="https://mintcdn.com/kodelabs/IXjGUtCN1G_ZdIHf/images/mobile-app/kode-os-mobile-fdd-incidents-list.png?fit=max&auto=format&n=IXjGUtCN1G_ZdIHf&q=85&s=4f8dd88491d6d5839ce178bdb6621a18" alt="FDD Events Incidents list showing incident IDs such as 260602-72408, affected fcu counts, and Alert priority badges" width="332" height="720" data-path="images/mobile-app/kode-os-mobile-fdd-incidents-list.png" />
      </Frame>
    </div>

    Rows show incident ID (for example, `260602-72408`), affected device count (`6 fcus`), and priority. Tap an incident for a summary sheet.

    <div className="flex justify-center w-full my-4">
      <Frame className="w-fit mx-auto" caption="Incident summary before full details">
        <img className="mx-auto block h-auto max-w-[400px] w-full" src="https://mintcdn.com/kodelabs/IXjGUtCN1G_ZdIHf/images/mobile-app/kode-os-mobile-fdd-incident-detail-sheet.png?fit=max&auto=format&n=IXjGUtCN1G_ZdIHf&q=85&s=0461d21729bbe84994f9f95cc85b4700" alt="Incident sheet with 11 events, Floor 1 area, and assignee name" width="400" height="868" data-path="images/mobile-app/kode-os-mobile-fdd-incident-detail-sheet.png" />
      </Frame>
    </div>

    Select `Incident Details` for charts, table view, and activity logs.

    ### Incident details

    The incident page includes summary metrics, charts, and child events.

    <div className="flex justify-center w-full my-4">
      <Frame className="w-fit mx-auto">
        <img className="mx-auto block h-auto max-w-[400px] w-full" src="https://mintcdn.com/kodelabs/IXjGUtCN1G_ZdIHf/images/mobile-app/kode-os-mobile-fdd-incident-summary-cards.png?fit=max&auto=format&n=IXjGUtCN1G_ZdIHf&q=85&s=293ddb508aab6333d8ce63ec26e139a1" alt="Incident 260528-84496 with event count, status donut, and areas chart" width="400" height="868" data-path="images/mobile-app/kode-os-mobile-fdd-incident-summary-cards.png" />
      </Frame>
    </div>

    Scroll for device-type and timeline charts, then `Table View` for each child event and `Activity Logs` for merges and notifications.

    <div className="flex justify-center w-full my-4">
      <Frame className="w-fit mx-auto" caption="Device types and timeline">
        <img className="mx-auto block h-auto max-w-[400px] w-full" src="https://mintcdn.com/kodelabs/IXjGUtCN1G_ZdIHf/images/mobile-app/kode-os-mobile-fdd-incident-device-types.png?fit=max&auto=format&n=IXjGUtCN1G_ZdIHf&q=85&s=8bacd7f6e8894d8888f1150090e5a367" alt="Incident affected vav donut and overall impact timeline" width="400" height="868" data-path="images/mobile-app/kode-os-mobile-fdd-incident-device-types.png" />
      </Frame>
    </div>

    <div className="flex justify-center w-full my-4">
      <Frame className="w-fit mx-auto">
        <img className="mx-auto block h-auto max-w-[400px] w-full" src="https://mintcdn.com/kodelabs/IXjGUtCN1G_ZdIHf/images/mobile-app/kode-os-mobile-fdd-incident-table-logs.png?fit=max&auto=format&n=IXjGUtCN1G_ZdIHf&q=85&s=54251ed3a79ddccb542cdb0d6f0945ee" alt="Incident table view with Damper Fully Open and Heating Stuck Open events plus activity log" width="400" height="868" data-path="images/mobile-app/kode-os-mobile-fdd-incident-table-logs.png" />
      </Frame>
    </div>
  </Tab>
</Tabs>

## FDD Reports from a device

<span id="fdd-reports-from-a-device" />

Open `FDD` from the [device](/products/mobile-app/building/devices#device-menu) `More` menu (or from an [area](/products/mobile-app/building/areas)). `FDD Reports` lists events and alarms for that equipment.

<Tabs>
  <Tab title="Active">
    `Active` lists events and alarms that are currently open on the device.

    <div className="flex justify-center w-full my-4">
      <Frame className="w-fit mx-auto" caption="Active FDD reports for the device">
        <img className="mx-auto block h-auto max-w-[400px] w-full" src="https://mintcdn.com/kodelabs/IXjGUtCN1G_ZdIHf/images/mobile-app/kode-os-mobile-device-fdd-reports.png?fit=max&auto=format&n=IXjGUtCN1G_ZdIHf&q=85&s=087c6437fbe8d1a53759689e83af6274" alt="FDD Reports Active tab with Discharge Air Temp Low Limit fault and date range" width="472" height="1024" data-path="images/mobile-app/kode-os-mobile-device-fdd-reports.png" />
      </Frame>
    </div>

    Each row shows the fault name and occurrence window. Tap a row to open the summary sheet, then `Event Details`.
  </Tab>

  <Tab title="Inactive">
    `Inactive` lists events and alarms that are no longer active (history).
  </Tab>
</Tabs>

## Compare to web

| Web capability                       | Mobile               |
| ------------------------------------ | -------------------- |
| Events and incidents lists           | Yes                  |
| Incident analytics and table view    | Yes                  |
| Event detail, points trend, comments | Yes                  |
| Create work order from event         | Yes (limited fields) |
| Pause or resume streaming            | Refresh and filters  |
| Export table                         | Use web              |

## Next steps

<CardGroup cols={2}>
  <Card title="Event dashboards" icon="layout-grid" href="/products/mobile-app/events/customize-event-dashboard" arrow={true}>
    Review Active and Historical FDD KPIs.
  </Card>

  <Card title="Manage FDD faults" icon="wrench" href="/products/mobile-app/diagnostics/manage-fdd-faults" arrow={true}>
    Inspect fault lifecycle metrics and trends.
  </Card>

  <Card title="FDD overview" icon="stethoscope" href="/products/mobile-app/diagnostics/fdd-overview" arrow={true}>
    Choose the right FDD screen for the job.
  </Card>
</CardGroup>
