Metric Delta

Renders a key performance indicator with its current value and a numerical

Surfaces
webmeet-stagegooglechatemailpdfapps-script-web
Fields
FieldType
labelstring (descriptive label for the metric, e.g., 'Sales')required
current_valuestring (the current formatted value, e.g., '$12,345')required
delta_valuestring (the formatted change value, e.g., '+$1,234' or '+10%')required
delta_typeenum (increase, decrease, no_change) - determines icon/colorrequired
unitstring (optional, unit for the current value, e.g., 'USD')optional
previous_period_labelstring (optional, e.g., 'vs. last month')optional
Example payload
{
  "type": "metric_delta",
  "label": "Metric Delta",
  "current_value": "Current value",
  "delta_value": "Delta value",
  "delta_type": "increase"
}
ARD catalog entry
{
  "identifier": "urn:air:a2uicatalog.ai:atom:metric_delta",
  "displayName": "Metric Delta",
  "type": "application/vnd.a2ui.atom+json",
  "url": "https://a2uicatalog.ai/atoms/metric_delta",
  "capabilities": [
    "web",
    "meet-stage",
    "googlechat",
    "email",
    "pdf",
    "apps-script-web"
  ],
  "description": "Renders a key performance indicator with its current value and a numerical",
  "representativeQueries": [
    "show a big number metric with directional change indicator or percentage",
    "renders a key performance indicator with its current value and a numerical",
    "render a metric delta"
  ]
}
← Full ARD catalog Try it live →
Deploy your own renderer

The renderer is open source. Deploy your own instance in 4 commands — you own the URL, no dependency on the demo endpoint.

git clone https://github.com/a2uicatalog/a2ui
cd apps-script-surface/gas-schema-renderer
clasp push && clasp deploy
Full deploy guide →