Dashboard: Data widget - calculated metrics

🎯 Overview

Calculated metrics allow you to create custom values inside a Data Widget by combining existing metrics with mathematical expressions. This is useful for defining KPIs such as conversion rates, ratios, or performance indexes. Metrics from the calculated metrics field do not have to be selected as metrics as well.

🔍 General Rules

• Original names only

  • The formula field must contain only original metric names, not display names.
  • Original names can be found on the widget’s details side (after creation) or in the integration’s native interface.
  • Using display names will cause formulas to fail.

• Mathematical expressions

  • Any valid mathematical expression is allowed.
  • Examples include addition, subtraction, multiplication, division, and more complex formulas.
  • Parentheses can be used to control order of operations.

➕ Fields

• Metric name — the user-facing label (e.g., Conversion Rate).
• Metric formula — the mathematical expression using original metric names (e.g., conversions/sessions).
• Metric type — select the type (number, percentage, etc.).
• Controls — add or remove calculated metrics with plus (+) and minus (-) buttons.

📝 Example

Code: conversions/sessions → A calculated metric showing the percentage of sessions that resulted in conversions.

⚠️ Key Notes

• Always verify metric names against the integration’s native interface or widget details.
• Incorrect naming will result in errors or empty data.
• Calculated metrics are an advanced feature — best used when you need precise KPIs or custom performance indicators.