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

# Configure Data Refresh Schedules in Cano Analytics

> Set how often Cano Analytics syncs each connected data source, trigger manual refreshes, and troubleshoot failed syncs to keep your dashboards accurate.

Cano Analytics syncs data from your connected sources on configurable schedules so your dashboards and queries always reflect up-to-date information. You choose how frequently each source refreshes — from real-time streaming down to weekly snapshots — and you can trigger a manual sync at any time from the source detail page.

## Refresh Frequency Options

When you set or edit a sync schedule, you can choose from the following refresh intervals:

| Frequency         | Description                                                  | Plan Availability     |
| ----------------- | ------------------------------------------------------------ | --------------------- |
| **Real-time**     | Continuous streaming sync; new records appear within seconds | Pro & Enterprise only |
| **Hourly**        | Syncs once per hour, on the hour                             | All plans             |
| **Every 6 hours** | Syncs four times per day                                     | All plans             |
| **Daily**         | Syncs once per day at a time you specify                     | All plans             |
| **Weekly**        | Syncs once per week on a day and time you specify            | All plans             |
| **Manual**        | Syncs only when you trigger it explicitly                    | All plans             |

<Note>
  **Real-time streaming** is available on the **Pro** and **Enterprise** plans only. If you're on the Starter plan and need lower latency syncs, [upgrade your plan](https://app.canoanalytics.io/settings/billing) or use the Hourly schedule as your most frequent option.
</Note>

## Configure a Sync Schedule

To set or update the refresh schedule for a connected source:

<Steps>
  <Step title="Open Data Sources settings">
    Navigate to **Settings → Data Sources** in the Cano Analytics app.
  </Step>

  <Step title="Select your source">
    Click the name of the data source whose schedule you want to configure.
  </Step>

  <Step title="Open the edit panel">
    Click **Edit** in the top-right corner of the source detail page.
  </Step>

  <Step title="Choose a refresh frequency">
    Under the **Refresh Schedule** section, select your preferred sync frequency from the dropdown. For Daily or Weekly options, also set the preferred sync time and day.
  </Step>

  <Step title="Save your changes">
    Click **Save**. The new schedule takes effect immediately — the next sync will run at the next scheduled interval.
  </Step>
</Steps>

## Trigger a Manual Refresh

To sync a source immediately without waiting for the next scheduled run, open the source's detail page from **Settings → Data Sources** and click the **Sync Now** button. Cano kicks off a full sync in the background and updates the **Last Synced** timestamp when it completes.

<Tip>
  Use **Sync Now** after updating connection credentials or making schema changes to your source, so Cano picks up the latest structure before the next scheduled sync.
</Tip>

## Last Synced Timestamp

The last time a source was successfully synced is displayed on its source detail card under **Settings → Data Sources**. The card shows:

* **Last Synced** — the date and time of the most recent successful sync
* **Next Sync** — the scheduled time for the next automatic sync
* **Sync Status** — the current state of the source (see table below)

## Sync Status Reference

| Status        | Meaning                                                                        |
| ------------- | ------------------------------------------------------------------------------ |
| **Syncing**   | A sync is actively in progress for this source                                 |
| **Success**   | The last sync completed without errors                                         |
| **Failed**    | The last sync encountered an error; see logs for details                       |
| **Scheduled** | No sync is currently running; the source is waiting for its next scheduled run |

## Troubleshooting Failed Syncs

If a source shows a **Failed** status, work through these steps to diagnose the issue:

1. **Check credentials** — Open the source's edit panel and verify that the username, password, or API key is still valid. Credentials can expire or be rotated without notice.
2. **Verify network and firewall rules** — Confirm that Cano's static egress IPs are still allowlisted in your firewall. See [Connect a Data Source](/docs/data-sources/connecting-a-source) for the current IP list.
3. **Review sync logs** — Click **View Logs** on the source detail page to see the full error message from the failed sync attempt. Common errors include authentication failures, SSL mismatches, and connection timeouts.
4. **Re-test the connection** — After making any changes, click **Test Connection** to confirm Cano can reach your source before the next scheduled sync.

<Warning>
  If a source fails to sync three times in a row, Cano pauses the automatic sync schedule and sends a notification to your workspace admins. Resume syncing by fixing the underlying issue and clicking **Resume Schedule** on the source detail page.
</Warning>

## Next Steps

* Review credentials and firewall settings for your source → [Connect a Data Source](/docs/data-sources/connecting-a-source)