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

# Configure sync settings

> Pick which Shopify data flows into Spotzee, what (if anything) flows back, and which customer list new customers land on. Then start the initial sync.

Sync settings is the control panel for one connected store. Open it from the store card menu. The drawer has three sections: data from Shopify, data to Shopify, and the customer list assignment. The initial sync button sits at the bottom.

> [!NOTE]
>
> The drawer pops open automatically right after you connect a store. You can re-open it any time from the store card.

## Open sync settings

**1. Open Integrations**

Inside the project, open **Integrations**.

**2. Find the store card**

Each connected Shopify store has its own card. Pick the one you're configuring.

**3. Open the drawer**

Use the card menu to choose **Sync settings**. The drawer slides in.

## Data from Shopify (5 toggles, on by default)

Each toggle controls one category of data flowing from your store into Spotzee.

| Toggle | Pulls in | Detailed in |
| - | - | - |
| **Customer profiles** | Names, emails, phones, addresses, tags | [What syncs from Shopify](https://spotzee.com/docs/guides/shopify/data-from-shopify.md) |
| **Email marketing consent** | Email subscription state per customer | [What syncs from Shopify](https://spotzee.com/docs/guides/shopify/data-from-shopify.md) |
| **SMS marketing consent** | SMS subscription state per customer | [What syncs from Shopify](https://spotzee.com/docs/guides/shopify/data-from-shopify.md) |
| **Orders, checkouts, and carts** | Order history, in-progress checkouts, abandoned carts | [What syncs from Shopify](https://spotzee.com/docs/guides/shopify/data-from-shopify.md) |
| **Product catalogue** | Products and their collections | [What syncs from Shopify](https://spotzee.com/docs/guides/shopify/data-from-shopify.md) |

Turn off categories you don't need. For example, if you don't run product-personalisation campaigns, turn off the catalogue toggle to skip syncing product data.

## Data to Shopify (4 toggles, off by default)

Each toggle pushes data from Spotzee back to Shopify. Off by default; opt in to each one.

| Toggle | Pushes back | Detailed in |
| - | - | - |
| **Sync profile data to Shopify** | Fills in missing fields on Shopify customer records | [What syncs back to Shopify](https://spotzee.com/docs/guides/shopify/data-to-shopify.md) |
| **Sync email subscription to Shopify** | Email opt-out propagation | [What syncs back to Shopify](https://spotzee.com/docs/guides/shopify/data-to-shopify.md) |
| **Sync SMS subscription to Shopify** | SMS opt-out propagation | [What syncs back to Shopify](https://spotzee.com/docs/guides/shopify/data-to-shopify.md) |
| **Sync engagement to metafields** | Writes Spotzee engagement metrics onto Shopify customer metafields | [What syncs back to Shopify](https://spotzee.com/docs/guides/shopify/data-to-shopify.md) |

## Customer list

Spotzee creates and assigns a customer list when a store connects. The customer list picker shows the assignment when **Customer profiles** is on.

Two options:

* **Pick an existing list** from the dropdown.
* **Create a new list** named after the store from the same picker.

### One list per store

Each Shopify store gets its own dedicated list. Lists already assigned to another store are greyed out in the dropdown so you can't accidentally mix customers from different stores.

### Switching the list

You can change the assigned list. Existing contacts keep their Shopify external IDs; a re-sync updates those records rather than creating new contacts.

## Run the initial sync

Once toggles and customer list are configured, run the initial sync.

**1. Confirm toggles**

Double-check the sync-from toggles, sync-to toggles, and customer list assignment in the drawer.

**2. Start the initial sync**

Choose **Start initial sync** at the bottom of the drawer.

**3. Wait for completion**

The button changes to a progress indicator. Each enabled entity processes in turn (Customers → Orders → Products → Collections). Time depends on how much data your store carries; small stores finish in seconds, large stores take a few minutes.

After the initial sync completes, real-time webhooks keep your data current. You don't need to re-run the initial sync unless you change settings dramatically or suspect divergence.

## When to re-run sync settings

Open sync settings whenever you need to:

* Toggle a category on or off.
* Change which customer list new customers land on.
* Verify the current toggle state.
* Run a manual re-sync from the **Sync status** section (see [Sync operations](https://spotzee.com/docs/guides/shopify/sync-operations.md)).

## Next steps

> [card] [Sync operations](https://spotzee.com/docs/guides/shopify/sync-operations.md)
>
> Statuses, retries, and full re-syncs.

> [card] [Store details](https://spotzee.com/docs/guides/shopify/store-details.md)
>
> View the store record, scopes, and the readiness checklist.

> [card] [Journeys and segments](https://spotzee.com/docs/guides/shopify/journeys-and-segments.md)
>
> Build automations on Shopify events.

> [card] [Troubleshoot](https://spotzee.com/docs/guides/shopify/troubleshoot.md)
>
> What to do when sync stalls or data doesn't appear.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.