Copy as Markdown[Open in ChatGPT](https://chatgpt.com/?q=Read%20https%3A%2F%2Fcoralogix.com%2Fdocs%2Fuser-guides%2Fcustom-dashboards%2Ftutorials%2Fwidget-data-loading.md%20and%20help%20me%20with%20my%20question%20about%20this%20Coralogix%20documentation%20page.)[Open in Claude](https://claude.ai/new?q=Read%20https%3A%2F%2Fcoralogix.com%2Fdocs%2Fuser-guides%2Fcustom-dashboards%2Ftutorials%2Fwidget-data-loading.md%20and%20help%20me%20with%20my%20question%20about%20this%20Coralogix%20documentation%20page.)

# Widget data loading

Speed up dashboard load times by switching DataPrime widgets to **Fast** loading. A widget set to Fast serves a recently computed result when one is available, instead of recomputing the query every time the dashboard opens. Widgets keep their default **Latest** behavior unless you change them, so existing dashboards are unaffected.

Note

This feature is available for early-access customers. To request access and confirm your organization meets the feature criteria, contact your account representative or Support.

## What you need[​](#what-you-need "Direct link to What you need")

* A [DataPrime widget](https://coralogix.com/docs/docs/user-guides/custom-dashboards/widgets/dataprime-widget/.md) on a Custom Dashboard
* The [`TEAM-DASHBOARDS:UPDATE`](https://coralogix.com/docs/docs/user-guides/aaa/access-control/permissions/permissions-list/.md) permission

## How widget data loading works[​](#how-widget-data-loading-works "Direct link to How widget data loading works")

Each DataPrime widget runs in one of two loading modes:

| Mode                 | Behavior                                                                                                                                                                                                 |
| -------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Latest** (default) | The widget runs a fresh query every time it loads. Results always reflect the current state of your data.                                                                                                |
| **Fast**             | The widget serves a recently computed result when one is available within an allowed drift window. Data might be slightly older. If no eligible cached result exists, the widget computes fresh results. |

Fast loading uses the DataPrime query result cache. Cache eligibility depends on the query text, the selected time range, and how close the requested range is to a previously cached one. See [Cache eligibility](#cache-eligibility) for the exact rules.

The setting is stored as part of the widget configuration, so it stays consistent across page reloads, tabs, and users.

### Refresh behavior[​](#refresh-behavior "Direct link to Refresh behavior")

* **Manual refresh** bypasses the cache. Selecting the dashboard refresh control forces a fresh query for every widget, including those set to Fast.
* **Auto refresh** respects each widget's loading mode. A widget set to Fast continues to serve cached results between refreshes when eligible; a widget set to Latest always recomputes.

## Switch a single widget to fast loading[​](#switch-a-single-widget-to-fast-loading "Direct link to Switch a single widget to fast loading")

Use the widget settings panel when you want to change one widget at a time.

1. Open a Custom Dashboard that contains a DataPrime widget.
2. From the widget's more actions menu, select **Settings**.
3. In the **Data caching** field, select **Fast**.
4. Select **Save**.

The widget reloads using the new mode. When it serves a cached result, a **Fast** badge appears in the widget header.

## Manage data loading for multiple widgets[​](#manage-data-loading-for-multiple-widgets "Direct link to Manage data loading for multiple widgets")

Use the **DataPrime data loading** drawer to review and update the mode of every DataPrime widget on the dashboard in one place.

1. Open a Custom Dashboard.
2. From the dashboard more actions menu, select **DataPrime data management**.
3. In the drawer, locate the widget you want to update in the **Data caching** column.
4. Select **Latest** or **Fast** for each widget. To apply the same mode to every widget in the table, select a mode and then select **Apply to all widgets**.
5. Select **Apply**.

The drawer lists every DataPrime widget on the dashboard along with its visualization type. Other widget types do not appear in the drawer and are not affected by this feature.

## Fast indicator[​](#fast-indicator "Direct link to Fast indicator")

When a widget set to Fast serves a cached result, a **Fast** badge appears in the widget header. Hover over the badge to see when the data was computed:

```
Data from 10:45 (3 min ago)
```

The tooltip combines an absolute timestamp with a relative offset. It appears when you are querying near the current time. For historical time ranges, the freshness indicator is hidden to reduce visual noise.

If a manual refresh runs while the widget is loading, the badge clears once fresh results arrive.

## Cache eligibility[​](#cache-eligibility "Direct link to Cache eligibility")

Fast loading serves a cached result only when all of the following are true:

* The query text matches a cached query exactly.
* The selected timeframe is longer than 10 minutes.
* The requested timeframe is within the allowed drift of a cached timeframe.

If any condition is not met, the widget computes fresh results and caches them for future eligible requests.

### Allowed drift by timeframe[​](#allowed-drift-by-timeframe "Direct link to Allowed drift by timeframe")

Drift compares the requested timeframe to a cached one, not wall-clock time between requests. A "last 24h" dashboard reopened a minute later can still reuse the cached result because the requested range shifts only a few minutes.

| Query timeframe | Allowed drift                       |
| --------------- | ----------------------------------- |
| 10 min to 2 hr  | 30 sec                              |
| 2 hr to 100 hr  | 0.5% of the timeframe, up to 30 min |
| Over 100 hr     | 30 min                              |

For a 24-hour range, allowed drift is `1,440 × 0.5% = 7.2 min`. Two requests for "last 24 hours" submitted 7 minutes apart can return the same cached result.

## Limitations[​](#limitations "Direct link to Limitations")

* Applies to DataPrime widgets only. Other widget types are not affected.
* Mode is set per widget. There is no dashboard-wide or team-wide default.
* The query result cache is not active for timeframes shorter than 10 minutes. Widgets querying short windows always compute fresh results, even when set to Fast.

## Related resources[​](#related-resources "Direct link to Related resources")

* [DataPrime widget](https://coralogix.com/docs/docs/user-guides/custom-dashboards/widgets/dataprime-widget/.md)
* [Auto refresh](https://coralogix.com/docs/docs/user-guides/custom-dashboards/tutorials/auto-refresh/.md)
* [Configure time interval](https://coralogix.com/docs/docs/user-guides/custom-dashboards/tutorials/configure-time-interval/.md)