Sync to Store
The Sync to Store feature allows you to keep products synchronized between multiple Shopify stores with persistent links, conflict detection, and selective field syncing.
Overview
Sync to Store provides:
- One-way sync - Source store → Target store
- Persistent links - Products stay linked between stores
- Conflict detection - Alert when both stores changed
- Field selection - Choose which fields to sync
- Batch operations - Sync multiple products at once
Opening Sync to Store
- Select products in the main grid
- Open using one of these methods:
- Toolbar: Click Sync to Store
- Right-click: Sync to Store (N selected)
- Menu: Tools > Sync to Store
Sync Process
Step 1: Select Target Store
Choose the destination store from the dropdown. Only connected stores appear.
Step 2: Configure Sync Options
Match Method
How to link source and target products:
| Method | Description |
|---|---|
| SKU | Match by variant SKU (recommended) |
| Handle | Match by URL handle |
| Barcode | Match by variant barcode |
Sync Scope
What to sync:
| Scope | Description |
|---|---|
| Selected Only | Only selected products |
| All Linked | All previously linked products |
| Selected + Linked | Both selected and linked |
Create Missing
- Enabled - Create products in target if not found
- Disabled - Only update existing products
Step 3: Field Selection
Choose which fields to sync:
| Field | Description |
|---|---|
| Title | Product name |
| Description | Product description HTML |
| Price | Variant prices |
| Compare At Price | Original/sale prices |
| Inventory | Stock levels |
| Tags | Product tags |
| SEO | SEO title and description |
| Metafields | Custom fields |
| Media | Images and videos |
Step 4: Preview
- Click Preview
- Review what will happen:
- Products to create
- Products to update
- Products with conflicts
- Products to skip
Step 5: Execute Sync
- Review preview results
- Click Start Sync
- Monitor progress in the Sync Progress dialog
- Review results
Sync Progress Dialog
When syncing products, a progress dialog shows real-time status:
Progress Information
| Element | Description |
|---|---|
| Current Step | Which phase of sync is running |
| Progress Bar | Visual progress indicator |
| Estimated Time | Time remaining estimate (based on historical sync data) |
| Products Processed | Count of completed products |
| Errors/Warnings | Any issues encountered |
Sync Phases
- Preparing - Analyzing products and building sync plan
- Syncing Products - Uploading product data to target store
- Syncing Media - Uploading images/videos (if selected)
- Caching Results - Saving synced products to local cache
- Complete - Summary of results
Cancellation
Click Cancel to stop a sync in progress. Products already synced will remain in the target store; remaining products will be skipped.
Note: If you close the window during sync, a confirmation dialog appears warning that cancellation will stop the operation.
Sync Mode Selection
ProductManager automatically selects the optimal sync method based on data volume:
| Mode | Description | Best For |
|---|---|---|
| Standard API | Individual GraphQL calls | Small syncs (<50 products) |
| Bulk Operations | Shopify bulk mutation jobs | Large syncs (50+ products) |
This is configured in Settings > Sync tab.
Conflict Resolution
What Are Conflicts?
A conflict occurs when:
- Product exists in both stores
- Both have changed since last sync
- Changes might overwrite each other
Conflict Detection
Conflicts are detected by comparing:
- Last sync timestamp
- Updated timestamps in both stores
Resolving Conflicts
When conflicts are found:
- Conflict Resolution window opens
- For each conflict, see:
- Source value
- Target value
- Last synced value
- Choose resolution:
- Use Source - Overwrite target
- Keep Target - Don't change target
- Skip - Don't sync this product
Quick Actions
Apply to all conflicts:
- Use Source for All - Overwrite all targets
- Keep Target for All - Skip all conflicts
- Review Each - Decide individually
Product Links
How Links Work
When products are synced:
- A link is created (source GID ↔ target GID)
- Link stored locally in sync database
- Future syncs use link to find matches
Link Status
| Status | Meaning |
|---|---|
| Linked | Products connected |
| Pending | Will be linked on sync |
| Unlinked | No target product |
| Error | Link failed |
Managing Links
View Links:
- Select synced product
- View "Linked Products" in details
Unlink Products:
- Select linked product
- Click Unlink
- Future syncs won't affect target
Sync History
View past sync operations:
- Open Sync to Store
- Click History
- See:
- Sync date/time
- Products synced
- Created/updated/failed counts
- Error details
Advanced Options
Inventory Mode
How to handle inventory:
| Mode | Description |
|---|---|
| Replace | Set target to source value |
| Add | Add source to target |
| Skip | Don't sync inventory |
Status Mode
How to handle product status:
| Mode | Description |
|---|---|
| Sync | Match source status |
| Keep | Keep target status |
| Set Draft | New products as draft |
Sync Tag
Add a tag to synced products:
- Enable "Add sync tag"
- Template:
synced-from-{source-store} - Helps identify synced products
Use Cases
Development to Production
- Make changes on dev store
- Test thoroughly
- Sync to production store
- Only sync when ready
Regional Store Updates
- Update products in main store
- Sync to regional stores
- Regional can have different prices
- Keep descriptions in sync
Wholesale to Retail
- Maintain products in wholesale store
- Sync to retail store
- Different prices per store
- Same product info
Best Practices
- Always preview - Check before syncing
- Use SKU matching - Most reliable
- Sync regularly - Avoid large conflict batches
- Test first - Try with few products initially
- Monitor results - Check sync completed correctly
Troubleshooting
"No matching product found"
- Check match method
- Verify SKU/handle exists in target
- Enable "Create missing" option
"Sync failed for some products"
- Check error messages
- May be API rate limiting
- Retry failed items
"Many conflicts detected"
- Sync more frequently
- Consider one-directional workflow
- Review which store is source of truth
"Media not syncing"
- Large images may timeout
- Check target store storage limits
- Try syncing without media first
"Product created but not linked"
- May be duplicate detection issue
- Check for existing similar product
- Manually link if needed
Keyboard Shortcuts
| Shortcut | Action |
|---|---|
| Enter | Start sync |
| Escape | Cancel |
| Ctrl+P | Preview |