Retrying Failed Product Syncs

When a product sync fails, you can retry it after fixing the underlying issue.

Finding Failed Syncs

  1. Go to Data in the sidebar
  2. Click Products
  3. Look for entries with a red Failed status badge
  4. Recent failures appear at the top of the list

Understanding the Failure

Before retrying, understand why the sync failed:

  1. Click on the failed product sync entry
  2. Review the error message
  3. Note the product SKU and any specific details

Common Error Types

Error Meaning Action Needed
Duplicate SKU SKU already exists in destination Check for existing product, update SKU
Invalid field value Data format issue Fix the source product data
Required field missing Mandatory field is empty Add value to required field
Unauthorized Connection issue Reconnect HubSpot or QuickBooks

Fixing Common Issues

Duplicate SKU

  1. Check the destination system for existing product with same SKU
  2. Either delete the duplicate or change the source product's SKU
  3. Retry the sync

Invalid field value

  1. Review the source product in HubSpot or QuickBooks
  2. Fix the problematic field (prices should be numeric, etc.)
  3. Retry the sync

Missing required field

  1. Identify which field is missing from the error
  2. Add the required value to the source product
  3. Retry the sync

Connection issues

  1. Go to Settings then Connections
  2. Reconnect the affected system
  3. Return to retry the sync

Performing the Retry

Once you've fixed the issue:

  1. Go to Data then Products
  2. Find the failed sync
  3. Click to view details
  4. Click the Retry Sync button

What Happens During Retry

After clicking retry:

  1. Status changes to Pending
  2. The sync is queued for processing
  3. Product data is fetched from source
  4. Product is created/updated in destination
  5. Final status is Success or Failed

Using Full Sync Instead

For many failed products, a full sync may be easier:

  1. Fix all underlying issues first
  2. Go to Settings then Sync then Products
  3. Click Start Full Sync
  4. All products from source are re-synced

This is useful when:

  • Many products failed for similar reasons
  • You've made bulk changes to products
  • Initial setup had issues

Retry Limitations

Which syncs can be retried

  • Failed status - Can be retried
  • Pending status - Can be retried (re-queues the sync)
  • Success status - Cannot be retried (already completed)
  • Processing status - Wait for it to complete first

Product sync must be enabled

If product sync is disabled, retries won't work. Enable it in settings first.

Tips for Reducing Failures

  • Standardize SKUs - Use consistent format across both systems
  • Complete required fields - Ensure products have all necessary data
  • Test with one product - Before bulk imports, test single products
  • Monitor regularly - Check sync logs to catch issues early

If Retry Keeps Failing

If the same product keeps failing:

  1. Verify the source product data is valid
  2. Check the destination system for conflicts
  3. Review field mappings for issues
  4. Try creating the product manually in destination to identify the problem
  5. Contact support if issues persist