Docs
Product Sync Settings
Product Sync Settings
Configure how products synchronize between Square and WooCommerce.
Choose how products stay in sync between Square and WooCommerce. You can use real-time syncing, scheduled updates, or both.
Overview
SquareSync offers two synchronization methods:
- Real-time syncing — Immediate updates when changes occur
- Scheduled syncing — Batch updates at set intervals
You can use one or both depending on your needs.
Sync Methods
Updates happen immediately when products change on either platform.
Best for:
- High-accuracy inventory requirements
- Preventing overselling
- Busy stores with frequent sales
Requirements:
- Webhook configuration in Square
- Reliable server connection
Configuring Real-Time Sync
Enable Automatic Syncing
- Go to SquareSync for Woo > Settings > Products
- Enable Automatic Syncing on Product Update
- Save changes
Webhook Setup (Square to WooCommerce)
For Square changes to sync to WooCommerce:
- Webhooks must be configured in Square Developer Dashboard
- SquareSync handles this automatically when connected
- Verify webhooks are active in your Square app settings
Configuring Scheduled Sync
Step 1: Enable Scheduler
- Go to SquareSync for Woo > Settings > Products
- Turn on Automatic Scheduler toggle
Step 2: Set Update Frequency
Choose how often syncs run:
| Frequency | Best For |
|---|---|
| Hourly | Active stores, frequent changes |
| Twice Daily | Moderate activity |
| Daily | Stable catalogs |
| Weekly | Large catalogs, minimal changes |
Step 3: Select Data Fields
Choose which product data to sync:
- Stock — Inventory quantities
- Title — Product names
- SKU — Stock keeping units
- Price — Regular and sale prices
- Description — Product descriptions
Step 4: Configure Batch Size
Set how many products process per batch:
| Server Size | Recommended Batch |
|---|---|
| Small | 10-25 products |
| Medium | 25-50 products |
| Large | 50-100 products |
Large batch sizes may impact server performance. Start small and increase if your server handles it well.
Source of Truth
Decide which platform is the primary data source.
Square as Source
- Inventory managed primarily in Square POS
- Square data overwrites WooCommerce
- Best for retail-first businesses
WooCommerce as Source
- Inventory managed primarily online
- WooCommerce data overwrites Square
- Best for e-commerce-first businesses
Recommended Configurations
| Business Type | Real-Time | Scheduled | Source of Truth |
|---|---|---|---|
| Retail store with online sales | Yes | Daily backup | Square |
| Online store with POS | Yes | Daily backup | WooCommerce |
| Large catalog, low traffic | No | Hourly | Either |
| High-volume multi-channel | Yes | Hourly backup | Square |
Troubleshooting
Sync not running
- Check that scheduler is enabled
- Verify WP Cron is working
- Look for error messages in logs
Data not updating
- Confirm source of truth setting
- Check which fields are selected
- Verify products are linked
Server timeouts
- Reduce batch size
- Increase sync interval
- Check server resources
Conflicting data
- Review source of truth setting
- Check for manual edits on both platforms
- Establish clear editing workflow