Real-time Widget
The Real-time widget shows recent activity for a selected record type and source. It can calculate recent values as a sum, count, or average over a selected time span.
Inputs and Controls
| Control | Description |
|---|---|
| Chart type | Vertical bar, horizontal bar, line, or filled line chart. |
| Time span | Show the latest 5 minutes, 30 minutes, 1, 2, 4, 8, 16, or 24 hours. |
| Metric | Aggregate activity by sum, count, or average. |
| Record type | Select the record type used as the real-time data source. |
| Record source | Optionally limit the widget to one source. |
| Custom title | Add a title shown above the widget. |
Scheduled email snapshots
In dashboard emails, Real-time widgets are static snapshots captured when the email is first generated. Each card shows its value, capture timestamp, observed time window and the source owner's time zone. Source filters, exclusions and integer rounding follow the saved report. The email does not update after it has been sent.
Snapshot windows use elapsed minutes across daylight-saving changes. Records store dates and local times without a UTC offset; when a local time occurs twice at the autumn clock change, snapshots use PostgreSQL's standard-time occurrence. The storage format cannot distinguish the two occurrences of that local time.
Scheduled deliveries save these values before contacting the mail server. Retries, including retries after a worker restart or a failed delivery receipt, reuse the saved values and timestamp for the same occurrence, source report version and widget settings. A new scheduled occurrence captures fresh values. Changing the report, widget settings or source time zone creates a new snapshot. Preview emails capture a new snapshot for each preview.
Every retry checks current report access. Revoked shares, deleted reports and reassigned sources are omitted even when a saved snapshot exists. If a snapshot cannot be read, captured or saved, the scheduled delivery waits for a retry. If chart rendering fails, the timestamped value remains visible. Prepare existing installations with setup and the shipped migrations before running email workers.
Saved values from completed occurrences are removed on the next snapshot capture; deleting the dashboard removes its snapshots immediately.
Tips and good uses
Tips
- Use short time spans for operational views.
- Choose record types that arrive frequently enough to be meaningful.
- Pair it with Data Value widgets for summary KPIs.
Good uses
- Recent leads or conversions
- Last 30 minutes or 24 hours of activity
- Short-term campaign monitoring
- Operational dashboards
Configuration and Usage

Configuring the Real-time Widget

A sample usage of the Real-time Widget