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

# How Data Syncs

> Understand how SaleTides keeps your WooCommerce data up to date — initial import and real-time webhooks.

## Two sync mechanisms

SaleTides uses two complementary methods to keep your data current:

<CardGroup cols={2}>
  <Card title="Initial Import" icon="database">
    A one-time bulk import of your full WooCommerce history when you first connect your store
  </Card>

  <Card title="Real-time Webhooks" icon="bolt">
    Event-driven updates that fire automatically as new orders, customers, and products arrive
  </Card>
</CardGroup>

## Initial import

When you first connect your WooCommerce store, SaleTides fetches your entire order history along with all related data. The import runs in batches in the background and never affects your store's performance.

<Frame>
  <img src="https://mintcdn.com/saletides/fDaloHCRXqoDDQuI/images/import-progress.png?fit=max&auto=format&n=fDaloHCRXqoDDQuI&q=85&s=bb3a03fc8119813194620b071bc38198" alt="Import progress screen" width="1440" height="300" data-path="images/import-progress.png" />
</Frame>

See [Understanding your first import](/getting-started/understanding-your-first-import) for full details on what gets imported and how long it takes.

## Real-time webhooks

After the initial import, SaleTides automatically registers webhooks on your WooCommerce store. Webhooks are instant HTTP notifications — whenever something happens on your store, WooCommerce notifies SaleTides in seconds.

### What triggers a webhook update

<Tabs>
  <Tab title="Orders">
    | Event         | Trigger                         |
    | ------------- | ------------------------------- |
    | Order created | Customer places an order        |
    | Order updated | Status changes, order is edited |
    | Order deleted | Order is deleted in WooCommerce |
  </Tab>

  <Tab title="Customers">
    | Event            | Trigger                    |
    | ---------------- | -------------------------- |
    | Customer created | New account registered     |
    | Customer updated | Profile or address changes |
  </Tab>

  <Tab title="Products">
    | Event           | Trigger                         |
    | --------------- | ------------------------------- |
    | Product created | New product published           |
    | Product updated | Price, stock, or details change |
    | Product deleted | Product removed                 |
  </Tab>

  <Tab title="Subscriptions">
    | Event                | Trigger                                |
    | -------------------- | -------------------------------------- |
    | Subscription created | New subscription started               |
    | Subscription updated | Status changes (cancel, pause, resume) |
  </Tab>
</Tabs>

### How fast is it?

Webhook events are processed within a few seconds of the event occurring on your store. A new order placed on WooCommerce will appear in your SaleTides dashboard almost instantly.

## Data flow

```
Customer places order on your WooCommerce store
                    ↓
WooCommerce fires webhook → SaleTides API endpoint
                    ↓
         Order saved to SaleTides database
                    ↓
      Customer stats & metrics recalculated
                    ↓
        Dashboard updates automatically
```

## Verifying webhooks are active

<Steps>
  <Step title="Open your WordPress admin">
    Log in to your WordPress dashboard.
  </Step>

  <Step title="Navigate to webhooks">
    Go to **WooCommerce → Settings → Advanced → Webhooks**.
  </Step>

  <Step title="Check the status">
    You should see webhooks with **SaleTides** in the name, all showing status **Active**.
  </Step>
</Steps>

If webhooks show as Inactive or are missing, see [WooCommerce Webhooks troubleshooting](/integrations/woocommerce-webhooks).

## What is NOT synced in real time

<Note>
  These items are updated on a background schedule (typically within a few minutes) rather than instantly via webhook:

  * Cohort calculations
  * Customer attribute groupings
  * Source / UTM attribution
  * Daily summary metrics
</Note>
