How Synchronization Works
Two-way synchronization between Listybox and Etsy:
Push: Send listings from Listybox to Etsy
Pull: Get updates from Etsy to Listybox
Sync Frequency: 5-60 minutes (configurable)
Common Sync Errors
Error | Cause | Solution |
Sync won't start | Connection lost | Reconnect |
Listing count mismatch | Incomplete sync | Run full sync |
Changes not reflecting | Cache issue | Manual sync |
Sync stuck | API rate limit | Wait and retry |
Data loss | Conflict state | Contact support |
Error: "Sync Failed"
Causes
Connection issue: Internet or Etsy API access
Token expired: OAuth authorization invalid
Rate limiting: Too many requests sent
Etsy API outage: Temporary issue on Etsy
Solutions
Step 1: Check Connection
Go to Store Settings
Run Store Health Check
Check connection status
Step 2: Refresh Token
Click "Reconnect" if disconnected
Re-authorize on Etsy
Step 3: Try Manual Sync
Click "Sync Now" on store card
Wait for completion
If error persists, wait 15 minutes and retry
Error: "Listing Count Mismatch"
Causes
Deleted listings: Manually deleted on Etsy
Incomplete sync: Sync interrupted
Draft listings: Draft status on Etsy
Different filters: Different statuses shown
Solutions
Step 1: Run Full Sync Select "Full sync (all listings)" option Step 2: Check on Etsy
Go to Etsy Shop Manager
List all listings (Active, Draft, Inactive)
Note deleted listings
Step 3: Compare Filters
Select "All Statuses" in Listybox
Include Draft and Inactive
Compare counts
Error: "Data Conflict"
Cause
Same listing updated differently on both Listybox and Etsy.
Solutions
Option 1: Keep Listybox Version
Listybox data pushed to Etsy
Etsy changes lost
Option 2: Keep Etsy Version
Etsy data pulled to Listybox
Listybox changes lost
Option 3: Manual Merge
Review both versions
Manually select correct data
Edit and save listing
Error: "Sync Stuck"
Causes
Large data set: Too many listings
API rate limit: Etsy request limit exceeded
Network interruption: Connection dropped
Solutions
Step 1: Refresh Page
F5 or browser refresh
Return to dashboard
Check sync status
Step 2: Wait
Wait 15-30 minutes for rate limit
Etsy API limits reset
Try again
Step 3: Contact Support
Stuck sync may be continuing in backend
Support can check status
Error: "Partial Sync"
Causes
Faulty listings: Data errors in some listings
API errors: API rejected specific listings
Permission issue: No access to some listings
Solutions
Step 1: Review Sync Logs Check which listings failed and why Step 2: Check Failed Listings
View failed items list
Check each listing's Etsy status
Identify deleted or changed ones
Step 3: Manual Fix
Fix faulty listings individually
Re-link if still exists on Etsy
Remove from Listybox if deleted
Error: "Pricing Sync Error"
Causes
Currency mismatch: Different currency settings
Minimum price: Etsy minimum price rules
Price format: Decimal place issues
Solutions
Step 1: Check Currency Settings Both should be USD Step 2: Check Etsy Price Rules
Minimum listing price: $0.20
Shipping price may be required
Step 3: Manual Price Update
Edit listing in Listybox
Re-enter price
Push
Error: "Image Sync Failed"
Causes
File size: Too large (max 10MB)
File format: Unsupported format
Network timeout: Upload timed out
Solutions
Step 1: Check Image Specs
Format: JPG, PNG, GIF
Max size: 10 MB
Min resolution: 1000x1000 px
Step 2: Re-upload Image
Edit listing
Remove problematic image
Re-upload
Push
Sync Tips
Optimal Sync Settings
Active sales: Every 15 minutes
Medium activity: Every 30 minutes
Low activity: Hourly
Testing only: Manual
Preventing Sync Issues
Regular Health Check: Weekly connection check
Use single source: Make changes from either Listybox or Etsy
For big changes: Sync first, then change
Keep auto-sync on: Don't disable automatic sync
Frequently Asked Questions
How long does sync take?
Depends on listing count. Usually 2-5 minutes for 100 listings.
Why aren't my Etsy changes reflecting?
Depends on sync frequency. Use manual sync to speed up.
Deleted listing still shows in Listybox?
Deleted Etsy listings become archived in Listybox, not fully deleted.
Can I edit listings during sync?
Not recommended. Wait for sync to complete.
Will I lose all my data?
No, sync errors don't cause data loss. Data preserved on both sides.
Related Articles
## Changelog
Versiyon | Tarih | Değişiklik | Yazar |
1.0.0 | 2025-12-09 | İlk sürüm | Listybox Team |