Authorization Failures
Symptom: Can't complete Shopify authorization
Possible causes:
Not logged into correct Shopify store
Insufficient permissions in Shopify
Browser blocking pop-ups or cookies
Browser extension interference
Temporary Shopify API issues
Solutions:
Verify Shopify login:
Log out of all Shopify stores
Log back into the correct store
Try connecting again
Check permissions:
You must be store owner or have full permissions
Staff accounts may not have sufficient access
Ask store owner to perform connection
Browser troubleshooting:
Disable browser extensions temporarily
Clear browser cache and cookies
Try incognito/private browsing mode
Try different browser (Chrome, Firefox, Safari)
Allow pop-ups for markopolo.ai
Check Shopify status:
Visit status.shopify.com
Verify API is operational
Wait and retry if Shopify is experiencing issues
Integration Connection Drops
Symptom: Was connected, now showing disconnected
Possible causes:
Shopify API token expired or revoked
Store owner changed password
App was uninstalled from Shopify
Permissions were modified
Billing issues with Shopify store
Solutions:
Reconnect integration:
Go to Settings → Integrations
Click "Reconnect" on Shopify card
Complete OAuth flow again
Verify connection successful
Check Shopify app installation:
Log into Shopify admin
Go to Settings → Apps and sales channels
Verify markopolo app is installed
Reinstall if missing
Verify permissions:
Ensure app permissions weren't revoked
Check that API access is enabled
Confirm no changes to store access
Data Synchronization Issues
Products Not Syncing
Symptom: Products missing from catalog, outdated information
Possible causes:
Products not published in Shopify
Sync hasn't run yet
Integration connection lost
Product exceeds size limits
API rate limiting
Diagnosis:
Check product status in Shopify:
Verify products are published
Check "Online Store" sales channel is active
Ensure products aren't archived
Check sync status:
Go to Shopify integration card
View last sync timestamp
Check for error count
Solutions:
Trigger manual sync:
Integration card → More menu (⋮)
Click "Sync Now"
Select "Products"
Wait for completion
Wait for auto-sync:
Products sync every 15 minutes
Initial import can take 30+ minutes
Large catalogs may take hours
Verify product limits:
Most issues resolved under 10,000 products
Extremely large catalogs may need special handling
Contact support for catalogs > 50,000 products
Customer Data Not Updating
Symptom: Customer information outdated or missing
Possible causes:
Customer webhook not configured
Sync frequency delay
Customer privacy settings
GDPR data restrictions
Solutions:
Force customer sync:
Integration settings
Select "Sync Customers"
Wait for completion
Check webhook configuration:
Ensure customer webhooks are active
Verify customer created/updated webhooks exist
Respect privacy settings:
Customers who opted out won't sync
Email marketing unsubscribes are honored
GDPR deletions propagate automatically
Orders Not Appearing
Symptom: Recent orders missing from analytics
Possible causes:
Order webhook not configured
Order isn't "paid" status
Financial status is pending
Order created in draft
Diagnosis:
Check order status in Shopify:
Only "paid" orders typically sync
Pending payments won't show
Draft orders don't trigger webhooks
Verify webhook delivery:
Check Shopify webhook recent deliveries
Look for order created webhook
Note any failure messages
Solutions:
Trigger order sync:
Manual sync for orders
Should appear within minutes
Check order date range in analytics
Wait for payment:
Orders appear after payment confirmed
Pending payments won't show
Authorize-only transactions may delay
Cart Analytics Issues
Analytics Showing Zero
Symptom: Cart analytics widget shows no data
Possible causes:
Integration just connected (no historical data yet)
No cart activity in timeframe
Cart tracking not configured
Webhooks not firing
Solutions:
Wait for data accumulation:
markopolo only tracks carts going forward
Historical carts before connection aren't imported
Need 24-48 hours to accumulate meaningful data
Verify cart tracking:
Check that cart webhooks are configured
Ensure web pixels are installed
Test by creating a cart on your store
Test cart creation:
Visit your Shopify store
Add item to cart
Wait 5-10 minutes
Check if cart appears in markopolo
Incorrect Cart Values
Symptom: Cart values don't match Shopify
Possible causes:
Currency conversion issues
Multi-currency store configuration
Taxes not calculated correctly
Discounts applied differently
Solutions:
Verify currency settings:
Check default currency in markopolo
Ensure matches Shopify store currency
Multi-currency may require configuration
Check tax settings:
Cart value may be pre-tax or post-tax
Verify which value you're comparing
Shopify cart vs. markopolo cart may differ in timing
Contact support:
Provide specific cart examples
Include Shopify cart ID
Show value discrepancy
Support can investigate data flow