Getting Started with LGS Forge

This guide will help you get started with LGS Forge and sync your first Magic: The Gathering products to your Shopify store.

Installation

Shopify App Store (Embedded Mode)

1. Visit the Shopify App Store and search for "LGS Forge"
2. Click Add app on the LGS Forge listing
3. Review the permissions requested:
   • Read and write products
   • Read and write inventory
   • Read and write publications (for product visibility)
4. Click Install app to authorize LGS Forge
5. You'll be redirected to the LGS Forge dashboard

Standalone Mode (SaaS)

1. Visit app.lgsforge.com
2. Click Sign Up to create an account
3. Choose your signup method:
   • Email & Password: Enter your email and create a password (minimum 8 characters)
   • Google Sign-In: Use your Google account for quick access
4. After signup, you'll see your dashboard
5. Follow the Connecting Your Store guide to link your Shopify store

First-Time Setup

After installation, complete these initial setup steps:

1. Configure Metafields (Required)

Metafields store MTG-specific product data in Shopify (card number, rarity, mana cost, etc.).

1. Go to the Settings tab
2. Click on Metafield Setup
3. Review the required metafields:
   • Card Number
   • Set Code
   • Set Name
   • Rarity
   • Mana Cost
   • Card Type
   • Power/Toughness
   • Finish (Foil/Nonfoil)
4. Click Setup Metafields to create them in your Shopify store
5. Wait for the setup to complete (usually 10-30 seconds)
6. You'll see a green checkmark when metafields are ready

Why is this important? Without metafields, MTG-specific data won't be stored with your products.

2. Configure Pricing (Recommended)

Set up your pricing rules before your first sync:

1. Go to the Settings tab
2. Scroll to Pricing Configuration
3. Configure these settings:
   • Global Markup: Default 1.3x (30% markup)
   • Price Threshold: Apply markup to cards above this price (default: $1.00)
   • Rounding: Round prices to 2 decimal places (e.g., $4.99)
   • Minimum Prices: Set floor prices by rarity
     • Rare: $0.50
     • Mythic: $1.00
     • Common/Uncommon: $0.25
4. Click Save Pricing Configuration

See Pricing Configuration for detailed pricing options.

3. Select Your First Sets

Choose which MTG sets to sync:

1. Go to the Sync tab
2. Browse available sets in the Set Selector
3. Use the search bar to find specific sets (e.g., "Murders at Karlov Manor")
4. Filter by release status:
   • Released: Available now
   • Preview: Upcoming sets with preview cards
   • Coming Soon: Announced but not yet available
5. Click the checkbox next to each set you want to sync
6. Or click Select All to sync all released sets

Tip: Start with 1-2 popular sets for your first sync to test the process.

Your First Sync

Now you're ready to sync products!

Step 1: Preview Products (Optional)

1. With sets selected, click Preview on the Sync button
2. Review the products that will be created:
   • Product titles
   • Pricing
   • Variants (Normal, Foil, conditions)
3. Click Proceed to Sync when ready

Step 2: Start the Sync

1. Click the Sync Products button
2. Choose sync options:
   • Test Mode: Limit to 10-50 products for testing (optional)
   • Force Re-sync: Update existing products (optional)
3. Click Start Sync

Step 3: Monitor Progress

Watch the real-time sync progress:

• Phase 1: Building Product Cache (preparing data)
• Phase 2: Creating Collections (organizing by set)
• Phase 3: Syncing Products (uploading to Shopify)

You'll see:

• Progress bar with percentage complete
• Stats: Total, Processed, Created, Updated, Failed
• Current product being synced
• Estimated time remaining

The sync will complete automatically. You can navigate away and check progress later.

Step 4: View Your Products

After the sync completes:

1. Go to your Shopify Admin → Products
2. You'll see your new MTG products organized by set
3. Each product includes:
   • Product title (Card Name)
   • Variants for Normal/Foil and conditions (if enabled)
   • Pricing based on your configuration
   • Metafields with MTG data
   • Product images (card artwork)

Next Steps

Now that you've completed your first sync:

• Browse the Catalog - Explore all available MTG products
• Configure Automated Pricing - Set up daily price updates
• Review Sync History - Track all your sync jobs
• Fine-tune Pricing - Adjust markup and minimum prices

Quick Reference

Task	Location	Time
Setup metafields	Settings tab → Metafield Setup	10-30 sec
Configure pricing	Settings tab → Pricing Configuration	2-5 min
Select sets	Sync tab → Set Selector	1-2 min
Preview sync	Sync tab → Preview button	Instant
Sync products	Sync tab → Sync Products button	5-30 min
View products	Shopify Admin → Products	Instant

Common Questions

How long does a sync take? Depends on the number of products:

• 100 products: ~2-5 minutes
• 500 products: ~10-15 minutes
• 2,000+ products: ~30-60 minutes

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

What if my sync fails? Check the Troubleshooting guide for common issues and solutions.

Do I need to manually update prices? No! Set up automated price sync to update prices daily.

---

Next: Connecting Your Store →