KPI Tooltip

A KPI tooltip is a short on-screen explanation that appears when a user hovers over or selects a key performance indicator (KPI) in a dashboard, report, or manufacturing application. It is used to clarify what the KPI represents, how it is calculated, and how the displayed value should be interpreted in the operational context.

Typical contents of a KPI tooltip

In industrial and manufacturing systems, KPI tooltips commonly include:

• KPI name and definition: A plain-language description of the metric (for example, Overall Equipment Effectiveness or First Pass Yield).
• Calculation logic: A concise formula or explanation of inputs (for example, OEE = Availability × Performance × Quality).
• Units and time basis: Clarification of units (percent, hours, pieces) and the time window (shift, day, batch, rolling 30 days).
• Data source: A reference to where the data comes from, such as MES, ERP, historian, or quality system.
• Target or threshold: Optional display of goal, spec limit, or alert threshold used in the visualization.

Operational role in manufacturing environments

Within OT/IT dashboards, MES portals, and operations intelligence tools, KPI tooltips help ensure that different users interpret metrics consistently. They support:

• Alignment on definitions: Reducing variation in how operators, engineers, and managers understand the same KPI.
• Faster onboarding: Allowing new personnel to learn metric meaning without leaving the screen.
• Audit and compliance clarity: Providing quick access to metric definitions that may also be documented in controlled procedures or measurement system descriptions.

In regulated environments, the information in KPI tooltips is often aligned with formally approved metric definitions stored in quality manuals, SOPs, or data dictionaries. The tooltip itself is typically a UI element and not the controlled record, but it should be kept consistent with master documentation.

Common confusion

• KPI vs. KPI tooltip: The KPI is the metric or value being tracked; the KPI tooltip is the contextual help that describes that metric inside a software interface.
• Tooltip vs. documentation: A KPI tooltip summarizes key points; detailed rules, data lineage, and governance are usually documented in separate controlled documents or system configuration records.