Syncing Products

Learn how to select MTG sets and sync products to your Shopify store with LGS Ledger.

Overview

The sync process has three main steps:

1. Select Sets - Choose which MTG sets to sync
2. Preview Products (Optional) - Review products before syncing
3. Start Sync - Upload products to Shopify and monitor progress

Selecting Sets

Browsing Available Sets

The Set Selector shows all available MTG sets:

1. Go to the Sync tab
2. Scroll through the set list (paginated, 25 sets per page)
3. Each set card shows:
   • Set name - Full name (e.g., "Murders at Karlov Manor")
   • Set code - 3-letter code (e.g., "MKM")
   • Release date - When the set was released
   • Card count - Total cards in the set
   • Status badge - Coming Soon, Preview, or Released

Search and Filters

Search by Name or Code:

1. Type in the search bar at the top of the Set Selector
2. Search works for both set names and codes
3. Results update as you type (500ms delay)
4. Clear the search to see all sets again

Filter by Release Status:

• All Sets - Show everything
• Released - Currently available sets (most common)
• Preview - Upcoming sets with preview cards
• Coming Soon - Announced but not yet available

Digital-Only Sets: Sets marked as digital-only (Arena/MTGO exclusive) are automatically filtered out.

Selecting Sets

Individual Selection:

1. Click the checkbox next to any set name
2. The set is added to your selection
3. Click again to deselect

Bulk Selection:

1. Click Select All to select all visible sets
2. Click Deselect All to clear your selection
3. Use filters to narrow down, then Select All

View Selected Only:

1. Toggle Show Selected Only to see just your selected sets
2. Useful when you have many sets selected
3. Toggle off to browse all sets again

Sorting Sets

Click column headers to sort by:

• Set Name - Alphabetical order
• Set Code - 3-letter code alphabetically
• Release Date - Newest or oldest first
• Card Count - Most or fewest cards

Click again to reverse the sort order.

Previewing Products

Before syncing, you can preview what products will be created:

How to Preview

1. Select your desired sets
2. Click the dropdown arrow on the Sync Products button
3. Select Preview
4. A modal will open showing:
   • Total product count
   • First 50 products to be synced
   • Product titles, prices, and variants

What You'll See

Each product preview shows:

• Product Title - Card name + set
• Price - Based on your pricing configuration
• Variants - Normal/Foil options
• Condition variants (if enabled in settings)

Pagination

• Preview shows 50 products at a time
• Click Load More to see additional products
• Total count shown at the top

Approving or Canceling

• Proceed to Sync - Continue with the sync
• Cancel - Close the preview and adjust your selection

Tip: Use preview to verify pricing before syncing large set batches.

Starting a Sync

Basic Sync

1. Select your sets
2. Click Sync Products
3. The sync starts immediately
4. Monitor real-time progress (see Monitoring Progress)

Sync Options

Test Mode:

• Limit sync to a specific number of products (1-100)
• Useful for testing pricing or configuration
• Check Test Mode and enter product count
• Only the first N products from selected sets will sync

Specific Card Number:

• Sync only cards with a specific collector number
• Enter the card number (e.g., "042")
• Useful for adding individual cards
• Combine with set selection to target specific versions

Force Re-sync:

• Re-sync products that already exist in your store
• Updates pricing, variants, and metafields
• Useful after changing pricing configuration
• Check Force Re-sync before starting

Sync Process

Once you start a sync, it goes through three phases:

Phase 1: Building Product Cache

• Fetches MTG product data from the catalog
• Filters by your selected sets
• Applies pricing configuration
• Prepares products for upload
• Usually completes in seconds

Phase 2: Creating Collections

• Creates a Shopify collection for each set
• Organizes products by set automatically
• Skips if collections already exist
• Quick phase, usually under 1 minute

Phase 3: Syncing Products

• Uploads products to Shopify via API
• Creates product variants (Normal/Foil, conditions)
• Assigns metafields with MTG data
• Sets pricing and inventory
• This is the longest phase (depends on product count)

Monitoring Progress

Real-Time Progress Display

During a sync, you'll see:

Overall Progress:

• Progress bar (0-100%)
• Percentage complete
• Current phase name
• Estimated time remaining (ETA)

Statistics:

• Total - Total products to sync
• Processed - Products completed
• Created - New products added
• Updated - Existing products refreshed
• Failed - Products with errors

Current Activity:

• Product currently being synced
• Batch number (products are synced in batches of 10)

Phase-Specific Progress

Each phase shows:

• Phase name and status
• Individual progress bar
• Completed/Total count
• Checkmark when complete

Sync Duration

Expected sync times:

Product Count	Estimated Time
50 products	1-2 minutes
100 products	2-5 minutes
500 products	10-15 minutes
1,000 products	20-30 minutes
2,000+ products	30-60 minutes

Note: Times vary based on:

• Shopify API response times
• Number of variants per product
• Network speed
• Concurrent syncs

Navigating Away

You can safely navigate away during a sync:

• The sync continues in the background
• Check progress later in Sync History
• Return to the Sync tab to see live updates

After the Sync

Sync Completion

When the sync finishes, you'll see:

• Success message with results summary
• Total products created/updated
• Failed products (if any)
• Duration of the sync

Viewing Your Products

In Shopify Admin:

1. Go to Shopify Admin → Products
2. Filter by collections to see products by set
3. Each product includes:
   • Product title (Card Name)
   • Set-based collections
   • Pricing from your configuration
   • Variants (Normal, Foil, conditions)
   • MTG metafields (visible in product details)

In LGS Ledger:

1. Go to the Products tab (if available)
2. View all synced products with filters
3. Search by card name, set, or number
4. Sort by various attributes

Verifying Metafields

To check if metafields were properly set:

1. In Shopify Admin, open any synced product
2. Scroll to Metafields section
3. Look for the mtg namespace fields:
   • mtg.card_number
   • mtg.set_code
   • mtg.rarity
   • mtg.mana_cost
   • etc.

If metafields are missing, see Settings & Metafields.

Multiple Syncs

Running Multiple Syncs

You can sync multiple sets in sequence:

1. Select first batch of sets
2. Start sync
3. While sync is running, select different sets
4. Start another sync
5. Both syncs run independently

Multi-Sync Status:

• You'll see progress for all active syncs
• Each sync shows its own progress bar
• Results are tracked separately

Managing Concurrent Syncs

Best Practices:

• Limit to 2-3 concurrent syncs to avoid API rate limits
• Group related sets (same release window) together
• Monitor for failures when running multiple syncs

Sync Failures

Handling Failed Products

If some products fail to sync:

1. Check the sync results summary
2. Note the Failed count
3. Review Sync History for error details
4. Common failure reasons:
   • Missing metafield definitions
   • Invalid product data
   • Shopify API rate limits exceeded
   • Network timeouts

Retrying Failed Products

To retry products that failed:

1. Wait a few minutes (in case of rate limiting)
2. Re-run the sync with the same sets
3. Use Force Re-sync to update existing products
4. Check Troubleshooting if failures persist

Best Practices

For First-Time Syncs

1. Setup metafields first - Required before syncing
2. Configure pricing - Set your markup and minimums
3. Start small - Test with 1-2 sets (50-100 products)
4. Use preview - Verify pricing before large syncs
5. Use test mode - Sync 10-20 products initially
6. Check results - Verify products in Shopify before scaling up

For Large Syncs

1. Select sets in batches - Sync 5-10 sets at a time
2. Monitor progress - Watch for errors early
3. Schedule off-peak - Run large syncs during low-traffic hours
4. Verify collections - Check that collections were created
5. Test pricing - Verify pricing on a few products manually

For Regular Updates

1. Use force re-sync - Update existing products with new pricing
2. Schedule price syncs - Automate daily price updates (see Price Sync Scheduling)
3. Review history - Check past syncs for trends or recurring errors
4. Update metafields - If you add optional metafields, re-sync to populate them

Common Questions

Can I sync the same set multiple times? Yes. Re-syncing updates existing products. Use Force Re-sync to ensure updates apply.

What happens to products if I deselect a set? Deselecting a set does not delete products. They remain in your store until manually deleted.

Can I stop a sync in progress? Currently, syncs run to completion. You can delete unwanted products afterward.

How often should I sync?

• Initial sync: Sync all desired sets once
• New releases: Sync new sets when they release
• Price updates: Use automated price sync (daily recommended)
• Re-syncs: Only when changing pricing configuration significantly

Do syncs affect my Shopify product limit? Yes. Each product created counts toward your Shopify plan's product limit. Check your plan limits before syncing large set collections.

What if I hit Shopify API rate limits? LGS Ledger has built-in rate limiting (500ms delays). If you still hit limits, reduce concurrent syncs or contact support.

---

Previous: Connecting Your Store ← | Next: Pricing Configuration →