Multi-line chart — reusable trend visualization component
The multi-line chart component in Zenoti Marketplace displays multiple data series on a shared time axis, making it straightforward to compare trends across periods at a glance. This article explains how the chart behaves, how it adapts when data is dense or absent, and how to navigate it using only a keyboard.
Audience: Zenoti administrators and organization owners who review trend data within Marketplace add-on dashboards.
Before you begin
- You must have access to a Marketplace add-on that surfaces a multi-line trend chart in its dashboard or reporting view.
- Your role must allow you to view the Marketplace. Your administrator controls whether your role can see the Marketplace.
- If the chart shows no data, confirm that the add-on has been active for at least one reporting period and that usage has been recorded.
Steps
View trend data on the chart
The multi-line chart renders automatically when you open a dashboard or analytics view inside a supported add-on. No additional action is required to load it.
Each data series appears as a distinct line. For every data point on each line, the chart displays:
- A dot marker indicating the exact value at that period.
- A value label positioned near the dot.
- A horizontal grid line at the corresponding y-axis scale increment, helping you read the value against the scale.
The x-axis shows the time periods covered by the data. The y-axis scale adjusts to fit the range of values across all series.
Read the chart when many periods are shown
When the data spans more than eight periods, the chart automatically switches to a compact display mode:
- Value labels use a reduced font size to prevent overlap.
- The x-axis tick labels appear every other period rather than for every period, reducing crowding while preserving readability.
The underlying data for every period remains present and accessible — only the label density changes. You can still navigate to any period using keyboard controls (see the next section).
Navigate the chart with a keyboard
Every period column in the chart is a keyboard-focusable element. To move through the chart without a mouse:
- Press Tab to bring focus into the chart area.
- Use the arrow keys to move focus from one period column to the next.
- When a period column receives focus, the accessible label announces:
- The period label (for example, the date or period name shown on the x-axis).
- The value of every series at that period.
This means screen-reader users and keyboard-only users receive the same data that sighted users see from the dot markers and value labels.
Handle an empty chart
If no data is available for the configured time range, the chart area is replaced by an empty-state message. The message text is configured per add-on by Zenoti and describes the absence of data in context.
If you see this message and expect data to be present:
- Confirm the add-on subscription is active in My Apps.
- Check that at least one full reporting period has elapsed since activation.
- If data is still absent after a full period, contact Zenoti Support using the Support link in the Marketplace footer.
Note: The empty-state message is set per add-on. The wording you see may differ between add-ons.
Tips
- When comparing two or more series with very different scales, focus on the shape of each line rather than absolute y-axis values — the shared scale means a series with small values may appear nearly flat alongside a series with large values.
- Use keyboard navigation to capture exact per-period values for each series, especially in compact mode when value labels are reduced in size and may overlap visually.
- If the chart becomes difficult to read in compact mode (more than eight periods), check whether the add-on dashboard offers a date-range filter to narrow the period count and restore full-size labels.
- When sharing trend observations with colleagues, note both the period range and the series names, since the same chart component appears in multiple add-ons and the series names differ between them.
Troubleshooting
| Symptom | Likely cause | Resolution |
|---|---|---|
| Chart area shows an empty-state message despite the add-on being active | No data has been recorded for the selected period range | Wait for at least one full reporting period to elapse, then reload the page |
| X-axis labels are only shown for every other period | More than eight periods are in the current view, triggering compact mode | This is expected behavior; use keyboard navigation to access all period values, or apply a date filter to reduce the period count |
| A period column does not announce all series values when focused | The screen reader may not have received the full accessible label before it began reading | Move focus away from the column and back; if the issue persists, try a different screen reader or browser |
| Value labels overlap and are unreadable | Compact mode reduces font size but cannot always prevent overlap when series values are close together | Use keyboard navigation to read exact values, or reduce the date range to enter full-label mode (eight periods or fewer) |