---
title: "Dashboard"
description: "Create customizable dashboards with live widgets for monitoring tags, devices, and AI models"
source_url: https://ai-ops.com/docs/dashboard/introduction
---

# Dashboard

The dashboard is the landing page of Koios: a customizable grid of live widgets for monitoring. You can create multiple dashboards, each with its own set of widgets tailored to a specific process, area, or role.

## Managing Dashboards

Use the dashboard **selector** at the top of the page to switch between dashboards. The adjacent **three-dots menu** provides options to create a new dashboard, rename the current one, or delete it. To make a dashboard load automatically on login, click the **star icon** next to it in the selector dropdown. A filled yellow star marks your favorite.

## Customize Mode

Click **Customize** to enter edit mode. In this mode:

- Widgets show drag handles and resize grips
- You can **drag** widgets to reposition them on the grid
- You can **resize** widgets by dragging the bottom-right corner
- Edit, duplicate, and delete icons appear on each widget
- The **Add Widget** button becomes available

Layout changes are saved automatically. Click **Done** to exit edit mode.

## Adding a Widget

In customize mode, click **Add Widget** to open the widget configuration modal:

1. **Choose a widget type** from the grouped dropdown (Tags, Devices, or Models)
2. **Select the entity**: the tag, device, or model the widget will display
3. **Set a title** (optional, defaults to the widget type name)
4. **Configure display settings** using the tabs (varies by widget type)

The widget is placed at the first available position on the grid. You can drag it to a different spot after adding.

## Widget Types

### Tag Widgets

| Widget | Description |
|--------|-------------|
| **Tag Value** | Displays a single tag's live value with an optional ring gauge showing where the value falls within its configured range |
| **Tag Chart** | Plots one or more tags over time as a live-updating line chart |

### Device Widgets

| Widget | Description |
|--------|-------------|
| **Device Status** | Shows the device's connection state (Running, Stopped, or Failed) with optional error message |
| **Device Uptime** | Horizontal status timeline showing running/stopped/failed segments over time |
| **Device Execution** | Bar chart of recent scan cycle durations |

### Model Widgets

| Widget | Description |
|--------|-------------|
| **Model Status** | Shows the model's inference state with optional error message |
| **Model Uptime** | Horizontal status timeline showing running/stopped/failed segments over time |
| **Model Execution** | Bar chart of recent inference cycle durations |

## Widget Configuration

Each widget type has its own display settings, accessible when adding or editing a widget.

### Tag Value

| Tab | Settings |
|-----|----------|
| **Text** | Font size (sm / md / lg / xl), font weight, text color (auto or fixed) |
| **Ring** | Show ring gauge, ring color, ring size (60–200 px), ring thickness (1–20 px) |
| **Labels** | Decimal places override (-1 to 6, or auto from tag config), show units, show tag name |

When set to **auto**, text and ring colors follow the tag's live status: teal for running, red for failed, gray for stopped.

### Tag Chart

| Tab | Settings |
|-----|----------|
| **Time** | History period: 5 min, 10 min, 30 min, 1 hour, 8 hours, or 24 hours |
| **Line** | Line width, line smoothing, point size |
| **Fill** | Fill area under lines, fill opacity |
| **Display** | Show X-axis, show Y-axis, show legend, show events (overlays event markers on the time-series chart) |

Multiple tags can be added to a single chart widget. Each tag gets a unique color automatically.

### Status Widgets (Device & Model)

| Tab | Settings |
|-----|----------|
| **Text** | Font size, font weight, text color (auto or fixed) |
| **Labels** | Show entity name, show error message |

Uptime and Execution widgets require only an entity selection, with no additional display settings.

## Editing & Duplicating Widgets

In customize mode, click the **gear icon** on a widget to edit its title, entity, or display settings. Click the **copy icon** to duplicate a widget with all its settings. The duplicate is automatically placed at the next available position.

## Grid Layout

The dashboard uses a 12-column responsive grid. Widgets snap to grid cells and cannot overlap. On smaller screens the grid reduces to fewer columns (6 on tablets, 4 on large phones, 2 on small phones) and widgets reflow accordingly.

## What's Next

- [Trends](https://ai-ops.com/docs/trends/introduction.md): build multi-tag time-series charts for deeper historical analysis.
- [Devices](https://ai-ops.com/docs/devices/introduction.md): connect the industrial hardware that feeds your widgets.
- [Tags](https://ai-ops.com/docs/tags/introduction.md): define the data points shown in Tag Value and Tag Chart widgets.