Import your existing Square product catalog into WooCommerce. This guide covers importing simple products and products with variations.

Overview

The import process:

1. Select products from your Square catalog
2. Choose which data attributes to import
3. Configure batch settings for your server
4. Run the import

Importing Simple Products

Step 1: Access the Products Page

1. Go to SquareSync for Woo > Products
2. You'll see a list of all products in your Square catalog

Step 2: Select Products

1. Use checkboxes to select individual products
2. Or use the header checkbox to select all visible products

Step 3: Choose Import Settings

Click Import All and select which attributes to import:

Step 4: Configure Batch Settings

Adjust batch size based on your server capacity:

• Small servers: 10-25 products per batch
• Medium servers: 25-50 products per batch
• Large servers: 50-100 products per batch

Step 5: Run Import

1. Click Run Import
2. The import will run in the background, you can leave and come back.

Importing Products with Variations

Products with variations (sizes, colors, etc.) require setup in Square first.

Setup in Square

1. Navigate to your Square Dashboard Items section
2. Create Option Sets (e.g., Size: Small, Medium, Large)
3. Add option sets to relevant products
4. Generate variations and save

Import to WooCommerce

1. Go to SquareSync for Woo > Products
2. Select products that have variations
3. Click Import All
4. Choose attributes including variations data
5. Click Run Import

How Variations Work

When importing variations, SquareSync handles them intelligently:

1. Single variation imports first — It becomes a simple product initially
2. Additional variations arrive — Product converts to variable automatically
3. All variations consolidate — Nested under one parent product

This approach simplifies the initial import while maintaining flexibility as your catalog grows.

Best Practices

Before Importing

• Clean up your Square catalog first
• Ensure product names are consistent
• Verify stock levels are accurate

During Import

• Start with a small batch to test
• Monitor for any errors
• Stay on the page until complete

After Import

• Review imported products in WooCommerce
• Check that images transferred correctly
• Verify pricing and stock levels
• Conduct regular audits between systems

Troubleshooting

Import stops or fails

• Reduce batch size
• Check server memory limits
• Look for timeout errors in logs

Missing images

• Verify images exist in Square
• Check file size limits
• Ensure proper permissions

Incorrect stock levels

• Confirm source data in Square
• Check for multiple locations
• Verify sync settings

Variations not importing

• Ensure option sets are configured in Square
• Check that variations are generated
• Try importing parent product first