Skip to main content

​
What are Latest Snapshots?

A latest snapshot is a widget on an evaluation group dashboard that computes against only the most recently created evaluation in a group.
“Most recent” is defined as the evaluation in the group with the latest created_at timestamp — not the order in which evaluations were added to the group.

​
When to use it

  • Snapshot tiles at the top of a dashboard that need to read the last run’s score.
  • Comparison views where you want the latest run highlighted alongside trend visualizations of the full group.
  • Always-fresh KPI widgets that should automatically refocus on a new evaluation as soon as it’s added to the group.

​
Where it applies

Latest snapshots are only available on widgets that issue a query.
Widget typeLatest Only available?
Metric (Query Value)Yes
BarYes
HistogramYes
DonutYes
Table (grouped or flat)Yes
ScatterYes
TimeseriesYes, but rarely useful — collapses the chart to a single point
Markdown, HeadingNot applicable
The toggle is only available on evaluation group dashboards.

​
Enable via the UI

Toggle Latest only in the widget modal when creating or editing a widget.
Latest only toggle in the Add Widget modal

​
Enable via the SDK

Set latest_only: true on the query payload when creating or updating the widget. The flag is supported on both SeriesQuery (Bar / Histogram / Donut / Table / Scatter / Timeseries) and MetricQuery (Metric / Query Value). 
# Metric widget that always shows the average score of the most recent run in the group
client.evaluation_dashboards.widgets.create(
    dashboard_id=dashboard.id,
    title="Latest Snapshot: Average Score",
    type="metric",
    query={
        "select": [
            {
                "expression": {
                    "type": "AGGREGATION",
                    "function": "AVG",
                    "column": "overall_score",
                    "source": "data",
                },
            }
        ],
        "latest_only": True,
    },
)
Omitting latest_only or setting it to false keeps the existing behavior of computing across the full group.