If products from Square aren't appearing in WooCommerce, follow this guide to diagnose and fix the issue.

Quick Checks

Before diving deeper, verify these basics:

1. SquareSync is connected — Check connection status in SWS Pro > Settings
2. Import is enabled — Verify auto-import is toggled on
3. Products exist in Square — Confirm products are in your Square catalog

Common Causes

1. WP-Cron Not Running

The most common cause of import issues is WordPress's built-in cron not firing.

Symptoms:

• Products stuck in queue
• Imports work manually but not automatically
• Long delays between syncs

Solution: Set up a server-side cron job for reliable background processing.

→ Server-Side Cron Setup Guide

2. Queue Backlog

A large queue can slow down or stall imports.

Symptoms:

• Many items pending in queue
• Slow import progress
• Server timeouts

Solution: Enable rate-limiting and request delays to manage the load.

→ Performance Settings Guide

3. Webhook Issues

Square webhooks may not be reaching your site.

Symptoms:

• No automatic imports at all
• Manual imports work fine
• Nothing in the sync queue

How to check:

1. Go to your Square Developer Dashboard
2. Navigate to Webhooks
3. Check for failed deliveries or errors

Solutions:

• Verify webhook URL is correct
• Check SSL certificate is valid
• Ensure firewall isn't blocking Square IPs
• Re-save webhook settings to refresh

4. Product Filters

Your filter settings may be excluding products.

Symptoms:

• Some products import, others don't
• Specific categories missing
• Location-filtered products not appearing

How to check:

1. Go to SWS Pro > Settings > Products
2. Review category and location filters
3. Check if excluded products match your filters

Solution: Adjust filter settings or temporarily disable to test.

Step-by-Step Diagnosis

Step 1: Check the Queue

1. Go to SWS Pro > Queue or check dashboard widget
2. Look for pending items
3. Note any failed items with error messages

Step 2: Review Sync Logs

1. Go to SWS Pro > Logs
2. Look for recent import attempts
3. Check for error messages or warnings

Step 3: Test Manual Import

1. Go to SWS Pro > Products
2. Select a product that isn't importing
3. Click Import Selected
4. Watch for success or error messages

If manual import works but automatic doesn't, the issue is likely WP-Cron.

Step 4: Verify Webhooks

1. Open Square Developer Dashboard
2. Go to your application's webhooks
3. Check delivery status and recent attempts
4. Look for 4xx or 5xx errors

If Queue Is Large

When you have a significant backlog:

1. Enable rate-limiting — Prevents server overload
2. Enable request delays — Spreads out processing
3. Set up server-side cron — Ensures consistent processing

→ Performance Settings

Still Having Issues?

If products still aren't importing:

• Check Queue Stalled guide
• Check Real-Time Sync Issues guide
• Review server error logs for PHP errors
• Contact support with your sync logs