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

# Navigate the KODE OS mobile app

> Move between your organization, portfolio map, building site, and apps in the KODE OS mobile app.

The mobile app has four levels of context: **workspace**, **organization**, **site**, and **module**. Most field work stays inside one site (building) at a time.

A **workspace** is your company login domain. An **organization** is the account that owns your sites and apps. A **site** is one building. A **module** is an app such as Events, Devices, or Schedules.

```mermaid actions={false} theme={"theme":{"light":"github-light","dark":"github-dark"}}
---
config:
  theme: neutral
  layout: dagre
---
flowchart TB
  A["Workspace sign-in"] --> B["Organization"]
  B --> C["Portfolio map or module picker"]
  C --> D["Site context"]
  D --> E["Site module launcher"]
  E --> F["Module screen"]

  linkStyle 0 stroke:#00C853,fill:none
  linkStyle 1 stroke:#00C853,fill:none
  linkStyle 2 stroke:#00C853,fill:none
  linkStyle 3 stroke:#00C853,fill:none
  linkStyle 4 stroke:#00C853,fill:none
```

## Organization context

After [sign-in](https://docs.kodelabs.com/products/mobile-app/get-started/sign-in-and-workspace.md), you work in one organization at a time. That organization controls which sites, apps, and data you see.

| Goal | Where to go |
| - | - |
| Switch organization | Profile → `Switch Organization`. See [Customize your experience](https://docs.kodelabs.com/products/mobile-app/get-started/customize-experience.md#switch-organization). |
| Return to sign-in | Profile → `Log out` |

Changing organization reloads the portfolio, site list, and every module. Bookmarks stay on the device but show data for the active organization only.

> [!NOTE]
>
> If you only see one organization, your administrator has not granted access to others.

## Portfolio vs building apps

KODE OS separates **portfolio** tools (all sites) from **building** apps (one site).

| Level | How you open it | What it covers |
| - | - | - |
| **Portfolio** | Swipe up the bottom sheet on the map; pick `Sites`, `Dashboards`, `Building BI`, `FDD`, `FTT`, `Work Orders`, `Bookmarks`, or `Search` | All sites you can access, or cross-site views |
| **Building** | Select a site, then open a module from the [site module launcher](#site-module-launcher) | One building (devices, events, schedules, and similar) |

Use portfolio tools when you compare sites. Use the building launcher when you operate equipment or triage events for one building.

Details for the map, sort, and search are in [Portfolio and sites](https://docs.kodelabs.com/products/mobile-app/portfolio/portfolio-and-sites.md).

## Site context

When you enter a building module, the bottom bar shows the **active site** and `Switch Site`.

| Action | What happens |
| - | - |
| `Switch Site` | Opens site selection; choosing another site reloads data for that building |
| Stay on current site | All module screens share the same site until you switch |
| Return to map | Swipe up `Portfolio` / `All Sites Overview` without signing out |

Site context does not change your organization. It only changes which building’s points, events, and assets load.

## Site module launcher

After you [enter a site](https://docs.kodelabs.com/products/mobile-app/portfolio/portfolio-and-sites.md#enter-a-site), swipe up the bottom sheet to open the **app launcher**. The header shows the site name, address, and `Switch Site`.

![Site module launcher with Systems, Areas, Devices, Points, and Data Sources icons and a list of Building BI, FDD Events, FDD Faults, FTT, Schedules, Trends, and OSS modules](https://mintcdn.com/kodelabs/MYYnSdKhTqQf34f4/images/mobile-app/kode-os-mobile-site-module-launcher.png?fit=max\&auto=format\&n=MYYnSdKhTqQf34f4\&q=85\&s=e84dc8a43daf6e39f12a35fe1db63ec5)

Site module launcher for KODE 1420 Office

A checkmark shows the active module. Tap a row or icon to switch apps.

> [accordion] Quick access icons
>
> | Icon | Module | Guide |
> | - | - | - |
> | `Systems` | Plant and equipment groupings | [Systems](https://docs.kodelabs.com/products/mobile-app/destinations/systems.md) |
> | `Areas` | Floors, zones, and floor plans | [Areas and floor plans](https://docs.kodelabs.com/products/mobile-app/building/areas.md) |
> | `Devices` | Equipment lists and device detail | [Devices](https://docs.kodelabs.com/products/mobile-app/building/devices.md) |
> | `Points` | Point status, filters, and writes | [Points](https://docs.kodelabs.com/products/mobile-app/building/points.md) |
> | `Data Sources` | Connectors and collection status | [Data sources](https://docs.kodelabs.com/products/mobile-app/building/data-sources.md) |

> [accordion] Module list rows
>
> | Module | Guide |
> | - | - |
> | `Building BI` | [Building BI](https://docs.kodelabs.com/products/mobile-app/destinations/building-bi.md) |
> | `FDD Events` | [Events](https://docs.kodelabs.com/products/mobile-app/events/work-with-events.md) |
> | `FDD Faults` | [Manage FDD faults](https://docs.kodelabs.com/products/mobile-app/diagnostics/manage-fdd-faults.md) |
> | `FTT` | [Functional testing](https://docs.kodelabs.com/products/mobile-app/diagnostics/functional-testing.md) |
> | `Schedules` | [Schedules](https://docs.kodelabs.com/products/mobile-app/operations/schedules.md) |
> | `Trends` | [Trends](https://docs.kodelabs.com/products/mobile-app/analytics/trends.md) |
> | `OSS` | [Optimized start/stop](https://docs.kodelabs.com/products/mobile-app/operations/oss.md) |
>
> Your site may also publish `Work Orders`, `Manual Meters`, `Bookmarks`, or `Writable Points` when your role and product enablement allow.

> [!NOTE]
>
> If a module is missing from the launcher, your role or site may not include it. AssetOps apps such as `Work Orders` require AssetOps to be enabled for the building. Confirm assignments with your administrator or in [Launchpad](https://docs.kodelabs.com/products/launchpad/channel-partners/product-enablement.md) on the web.

## Inside a module

Most building apps share the same screen patterns.

| Control | Typical use |
| - | - |
| `Back` (chevron) | Return to the previous list or parent screen |
| Title | Current asset, event, work order, or view name |
| Chat / comments | Collaboration on work orders, faults, or events when shown |
| `More` (`⋯`) | Status history, edit, share, watchers, or module-specific actions |

Detail screens often use horizontal tabs (for example, `Details`, `Attachments`, `Follow-ups`). Lists drill down to a record, then to sub-panels. Deep links from notifications open the target module when your role allows.

Many module home screens show a blue **bell** for notifications. List screens may show a `+` button for create actions when your permissions allow.

## Portfolio sheet and notifications

Swipe up the bottom handle labeled `Portfolio` or `All Sites Overview` from any building screen to return to the map or sites list. You keep your sign-in session and organization.

From the sheet you can open another site, switch to portfolio modules, or [reorder modules](https://docs.kodelabs.com/products/mobile-app/portfolio/portfolio-and-sites.md#reorder-modules).

Tap the blue **bell** on module home screens and the portfolio map to open `Notifications`. Alerts follow the same policies as KODE OS web for your role. Enable notifications in iOS or Android system settings if you declined the prompt earlier.

## Native screens and web views

| UI type | Examples |
| - | - |
| **Native** | Portfolio map, device lists, trends, most module lists and detail tabs |
| **In-app browser** | Sign-in, organization switcher, some profile links (Knowledge Base, Privacy Policy) |

Web views load `accounts.kodelabs.com` or your identity provider during sign-in and organization switch. Use `Done` or back to return to native navigation.

## Quick reference

| Goal | Start here |
| - | - |
| Change organization | [Customize your experience](https://docs.kodelabs.com/products/mobile-app/get-started/customize-experience.md#switch-organization) → `Switch Organization` |
| Pick another building | Bottom `Switch Site` or portfolio map |
| Open dashboards or cross-site FDD | Portfolio sheet → module row |
| Command a point or device | Launcher → `Devices` or `Points` |
| Triage an event | Launcher → `FDD Events` |
| Field maintenance | Launcher → `Work Orders` |
| Saved equipment | Launcher → `Bookmarks` |

## Next steps

> [card] [Portfolio and sites](https://docs.kodelabs.com/products/mobile-app/portfolio/portfolio-and-sites.md)
>
> Use the map, site cards, and site switcher.

> [card] [Customize experience](https://docs.kodelabs.com/products/mobile-app/get-started/customize-experience.md)
>
> Manage profile, theme, and organizations.

> [card] [Mobile app overview](https://docs.kodelabs.com/products/mobile-app/overview.md)
>
> See how mobile covers KODE OS modules.
