> ## Documentation Index
> Fetch the complete documentation index at: https://www.domo.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Configure Data Freshness and Caching in Cloud Integrations

## Intro

This article explains how to open the **Data Freshness** tab for a Cloud Integration, configure scheduled data freshness checks, and configure data caching for card query results.

***

## Overview

Cloud Integrations DataSets stay current through two mechanisms that you configure per integration:

* **Data freshness checks —** Domo polls your source cloud warehouse on a schedule to detect when the underlying data has changed. When an update is detected, connected cards, alerts, and DataFlows reflect the new data on their next load. Domo also performs on-demand freshness checks when a query is executed and the configured cache duration (TTL) has expired, providing more responsive data without relying solely on scheduled polling.
* **Data caching —** Domo stores the results of card queries temporarily. When a user opens a card, Domo returns the cached result if one exists rather than sending a new query to the warehouse. This reduces query load on your warehouse.

Both settings are configured at the integration level and apply to all DataSets within that integration.

## Open the Data Freshness Tab

To configure data freshness and caching for an existing integration:

1. Navigate to **Data Warehouse** > **Connect Data** > **Manage existing integrations**.

2. Select the tile for your integration type, such as BigQuery.

   <Frame>
     <img src="https://mintcdn.com/domoinc/k2xiHKKf_v8tfsbV/images/kb/data-freshness-01.png?fit=max&auto=format&n=k2xiHKKf_v8tfsbV&q=85&s=38062f9052e92028f8c0562fabdd9aa1" alt="Integration list with wrench menu open" width="1920" height="911" data-path="images/kb/data-freshness-01.png" />
   </Frame>

3. Hover over the integration you want to configure and select the wrench icon that appears, then select **Edit integration**.

   <Frame>
     <img src="https://mintcdn.com/domoinc/k2xiHKKf_v8tfsbV/images/kb/data-freshness-02.png?fit=max&auto=format&n=k2xiHKKf_v8tfsbV&q=85&s=7ee9ec5d44404c4a200589754f4ad545" alt="Integration detail showing the Settings tab" width="1920" height="911" data-path="images/kb/data-freshness-02.png" />
   </Frame>

4. Select the **Data Freshness** tab.

   By default, data freshness scheduling and caching are both disabled.

   <Frame>
     <img src="https://mintcdn.com/domoinc/k2xiHKKf_v8tfsbV/images/kb/data-freshness-03.png?fit=max&auto=format&n=k2xiHKKf_v8tfsbV&q=85&s=6a73c09a3087460c4f61137863953665" alt="Data Freshness tab in its default state, with scheduling and caching both off" width="1920" height="911" data-path="images/kb/data-freshness-03.png" />
   </Frame>

## Configure Data Freshness Checks

1. Enable the **Schedule data freshness checks** toggle.

2. Select the **Basic** or **Advanced** tab to set when Domo checks for updates.

### Basic

Basic mode lets you choose a preset update interval from a dropdown. Set the **Start Time** and **Time Zone** to control when within the interval checks begin. For sub-daily intervals (every 15 minutes, every 30 minutes, every hour), you can also enable **Active hours** to restrict checks to a defined time window.

<Frame>
  <img src="https://mintcdn.com/domoinc/k2xiHKKf_v8tfsbV/images/kb/data-freshness-04.png?fit=max&auto=format&n=k2xiHKKf_v8tfsbV&q=85&s=3a530c26c3af9881ad38af2f27ddd4eb" alt="Basic tab with the update interval dropdown open" width="1920" height="911" data-path="images/kb/data-freshness-04.png" />
</Frame>

| Update interval  | Description                                                             |
| ---------------- | ----------------------------------------------------------------------- |
| Every 15 minutes | Checks every 15 minutes, all day or during the configured active hours. |
| Every 30 minutes | Checks every 30 minutes, all day or during the configured active hours. |
| Every hour       | Checks every hour, all day or during the configured active hours.       |
| Every day        | Checks once per day at the specified time, including weekends.          |
| Every weekday    | Checks once per day at the specified time, excluding weekends.          |
| Every week       | Checks once per week on the selected day at the specified time.         |
| Every month      | Checks once per month on the selected date at the specified time.       |

### Advanced

Advanced mode gives you granular control over check frequency, day of the week, and monthly schedule. Configure all three settings to define exactly when checks run.

<Frame>
  <img src="https://mintcdn.com/domoinc/k2xiHKKf_v8tfsbV/images/kb/data-freshness-06.png?fit=max&auto=format&n=k2xiHKKf_v8tfsbV&q=85&s=c062223bb3c0c85eb810fd2543cd53cf" alt="Advanced tab with Once a day selected" width="1920" height="911" data-path="images/kb/data-freshness-06.png" />
</Frame>

**How frequently?**—How often within a day checks run:

* **Once a day —** Checks run once per day at the time and time zone you specify.
* **More than once a day —** Checks repeat throughout the day at the interval you specify. Enable **Active hours** to restrict checks to a defined window, such as 8 AM–6 PM.

<Frame>
  <img src="https://mintcdn.com/domoinc/k2xiHKKf_v8tfsbV/images/kb/data-freshness-07.png?fit=max&auto=format&n=k2xiHKKf_v8tfsbV&q=85&s=b95103cb66d288c2b873560a5f42c34a" alt="Advanced tab with More than once a day selected and Active hours enabled" width="1920" height="911" data-path="images/kb/data-freshness-07.png" />
</Frame>

**Day frequency**—Which days checks run:

* **Every day —** Checks run every day of the week.
* **Specific days of the week —** Checks run only on the days you select.
* **Specific days of the month —** Checks run only on the calendar dates you select.

**Month frequency**—Which months checks run:

* **Every month —** Checks run every month.
* **Specific months —** Checks run only in the months you select.

## Configure Data Caching

1. In the **Data Caching** section of the **Data Freshness** tab, turn on the **Enable caching** toggle.

2. Set **Cache Duration (TTL)** to control how long Domo retains cached card query results before discarding them. The maximum cache duration is 24 hours.

   <Frame>
     <img src="https://mintcdn.com/domoinc/k2xiHKKf_v8tfsbV/images/kb/data-freshness-08.png?fit=max&auto=format&n=k2xiHKKf_v8tfsbV&q=85&s=f3400b56fe0138a1186c4649d1f8c9a3" alt="Caching section with the Enable caching toggle being turned on" width="1920" height="911" data-path="images/kb/data-freshness-08.png" />
   </Frame>

## FAQ

### Data Freshness

<AccordionGroup>
  <Accordion title="Why doesn't my data appear to be up to date?">
    Make sure data freshness is enabled and configured to an interval that suits your use case. If data freshness is disabled, card query results may be cached for up to 24 hours.
  </Accordion>

  <Accordion title="Does data freshness work when my integration uses OAuth authentication?">
    No. Data freshness checks and caching depend on the service account used to connect your integration. These features are disabled when using OAuth.
  </Accordion>
</AccordionGroup>

### Caching

<AccordionGroup>
  <Accordion title="When does Domo always query the warehouse instead of using the cache?">
    Domo bypasses the cache and always sends a fresh query in these situations:

    * Viewing the DataSet preview on the DataSet's Details page
    * Loading a DataSet View
    * Loading a DataSet into Magic ETL
    * **Dynamic SQL functions**: Queries that include functions such as NOW(), CURRENT\_DATE(), or CURRENT\_TIMESTAMP() generate a unique SQL string on each execution. Caching is keyed on the exact SQL query, so these queries will not reuse cached results regardless of TTL setting.
  </Accordion>

  <Accordion title="Is the warehouse queried every time you view a card?">
    No. When you view a card, Domo first checks for a cached result. If one exists, Domo returns the cached data. If none exists, Domo queries the warehouse.
  </Accordion>

  <Accordion title="Is the warehouse queried when someone edits a card?">
    Yes. When building or editing a card in Analyzer, each change triggers a new query if **Auto Preview** is enabled.
  </Accordion>

  <Accordion title="How long are card query results cached?">
    Domo caches card query results for up to 24 hours or until the Cache Duration (TTL) expires—whichever comes first.
  </Accordion>

  <Accordion title="Is there a limit on the number of queries Domo will cache?">
    No. There is no explicit limit on the number of cached query results.
  </Accordion>

  <Accordion title="Is there a data size limit on what Domo will cache?">
    No. There is no row or data size limit on what is saved in the card cache.
  </Accordion>

  <Accordion title="Can I set a different cache duration for individual DataSets?">
    No. The cache duration is set at the integration level and applies to all DataSets within that integration.
  </Accordion>
</AccordionGroup>
