Creating KPI Cards
Cards are the building blocks of the KPI Dashboard. Each card focuses on one metric and displays it using a visualization type that suits the data. The card builder walks you through the configuration in a side panel — no code required.
Opening the Card Builder
- On an empty dashboard, click the large + button in the center of the screen.
- On a dashboard that already has cards, click the Add Card button in the top toolbar, or enter edit mode and click +.
The card builder opens as a panel on the right side of the screen. The dashboard remains visible behind it so you can see how the new card fits into your layout as you configure it.
Step 1: Card Title
Enter a short, descriptive title for the card. This label appears at the top of the card on the dashboard.
Keep titles concise — around 2 to 4 words works well. Examples: "Total Mileage", "Idle Time by Unit", "Speeding Events This Week".
Step 2: Visualization Type
Choose how the data should be displayed. See Card Types and Visualizations for a full description of each option.
| Option | Best for |
|---|---|
| Value | A single aggregated number |
| Ranking | Comparing units by a metric (horizontal bars) |
| Bars | Comparing across categories or time periods (vertical bars) |
| Trend | Watching a metric change over time (sparkline) |
| Compare | Two metrics plotted against each other (scatter) |
| Table | Detailed tabular view of the data |
Step 3: Data Source and Metric
Select where the data comes from and what to measure.
Data sources:
- Trips / Mileage — Trip-level data: distance, duration, start and end times.
- Idle Time — Engine-on, vehicle-stationary intervals detected via sensors.
- Speeding — Speed threshold violations captured from GPS events.
- Eco-Driving — Violation events such as harsh braking, rapid acceleration, and sharp cornering.
- Sensors — Activity recorded by custom sensors attached to specific units.
Metrics available depend on the data source. For example, selecting Idle Time exposes metrics like total idle duration, number of idle events, and average idle duration per event.
Aggregation controls how multiple values are combined into a single figure:
- Sum — Total across all units and the date range.
- Average — Mean value across units or time periods.
- Maximum — Highest single value recorded.
- Minimum — Lowest single value recorded.
- Count — Number of events or records.
Step 4: Grouping
Grouping determines how the data is sliced on the visualization.
| Grouping | Effect |
|---|---|
| By unit | One data point per vehicle |
| By day | One data point per calendar day |
| By week | One data point per week |
| By month | One data point per month |
Not all grouping options are available for every visualization type. For example, a Value card (single number) has no grouping — it always shows one aggregated result. A Ranking card always groups by unit.
Step 5: Create
Click Create Card. The card appears on the dashboard at its default size. You can resize and reorder it from edit mode.
Editing an Existing Card
To change a card's configuration after it has been created:
- Hover over the card to reveal the action icons.
- Click the pencil (edit) icon.
- The card builder opens with the card's current settings pre-filled.
- Make your changes and click Save.
Deleting a Card
- Hover over the card to reveal the action icons.
- Click the trash (delete) icon.
- Confirm the deletion when prompted.
Deleting a card is permanent. The configuration is not recoverable after confirmation.