Shopify Integration - Connect Your Shopify Store to AI Agents

Integrating Your Shopify Store with GXO.dev

Connect your Shopify store to GXO.dev and make your products discoverable by AI agents like ChatGPT, Claude, and Gemini.

This guide walks you through everything from setup to troubleshooting, ensuring your Shopify products are fully optimized for Agentic Commerce.

Prerequisites and Requirements

Shopify Store Requirements

Store Status

• Active Shopify store (not in development mode)
• Store must be publicly accessible
• Valid Shopify plan (Basic, Advanced, or Plus)
• Admin access to your Shopify store

Product Requirements

• Products have:
  • Title
  • Description
  • Price
  • At least one image
• Accurate inventory levels
• Proper category/taxonomy

Technical Requirements

• Stable internet connection
• Modern browser (Chrome, Safari, Edge, or Firefox)
• JavaScript enabled
• Pop-up blockers disabled

GXO.dev Account Requirements

Account Setup

• Active GXO.dev account
• Completed profile setup
• Active subscription plan (Starter or higher)
• Team permissions (if applicable)

Permissions Needed

• Platform integration access
• Product management rights
• Analytics access
• Settings modification permissions

💡 Tip: If you’re part of a team, ensure your user role includes “Integrations” and “Products” permissions in Settings → Team → Members.

Step-by-Step Connection Guide

Step 1: Access Shopify Integration

1. Log in to your GXO.dev dashboard
2. Click Integrations in the sidebar
3. Select Shopify
4. Click Connect Shopify Store
5. You’ll be redirected to the setup page

Step 2: Enter Store Information

1. Enter Store Domain

   • Format: yourstore.myshopify.com
   • Example: mystore.myshopify.com
   • Exclude https:// or trailing slashes

2. Verify Store URL

   • GXO.dev confirms the store exists
   • Must be publicly accessible
   • Ensure it’s not in development mode

Step 3: Shopify OAuth Authorization

1. Redirect to Shopify

   • Click Connect to Shopify
   • Log in to your Shopify admin (if prompted)

2. Review Permissions

   • read_products – access product details
   • read_inventory – access inventory counts
   • read_orders (optional) – access order data for analytics

3. Authorize Connection

   • Click Install App
   • Review and approve requested scopes
   • Confirm installation

Step 4: Connection Verification

1. You’ll be redirected back to GXO.dev
2. Your Shopify store will appear as Connected
3. A success message confirms setup completion
4. Review the connection status indicator (🟢 Green = Active)
5. Confirm first product sync has started

OAuth Scopes and Permissions

Required Permissions

read_products

• Purpose: Access product details for AI agent discovery
• Data Accessed: Titles, descriptions, prices, images
• Usage: Create ACP-compliant product feeds
• Security: Read-only

read_inventory

• Purpose: Track inventory for accurate AI recommendations
• Data Accessed: Stock counts, statuses
• Usage: Maintain real-time product availability
• Security: Read-only

Optional Permissions

read_orders

• Purpose: Track AI-attributed sales and conversions
• Data Accessed: Order summaries and totals
• Usage: Analytics attribution
• Security: Read-only

read_customers

• Purpose: Enable personalization analytics
• Data Accessed: Customer demographics and purchase history
• Usage: Personalized AI recommendations
• Security: Read-only

Permission Management

View Current Permissions

• Go to Integrations → Shopify → Settings
• Review permission status and expiration
• Monitor API usage

Updating Permissions

• Re-authorize if scopes change
• Remove unused permissions
• Regularly verify token validity

Product Sync Settings

Automatic Synchronization

Real-Time Updates

• Inventory changes sync immediately
• Price updates reflected within minutes
• Product additions sync automatically

Sync Frequency Options

Manual Synchronization

Force Sync

• Click Sync Now
• Use when troubleshooting or validating data
• Ensures immediate data refresh

Selective Sync

• Sync by product category, tag, or vendor
• Filter out draft or hidden items
• Update specific listings only

Sync Configuration

Product Filtering

• Include/exclude by product type
• Filter by minimum price threshold
• Exclude out-of-stock items

Data Mapping

• Map Shopify fields to ACP format
• Customize product descriptions and metadata
• Configure variant handling (size, color, etc.)

Advanced Configuration

Custom Product Mapping

Field Mapping

• Map Shopify fields → ACP fields
• Configure variant data (SKU, options)
• Define AI-relevant metadata (tags, material, features)

Data Transformation

• Add natural-language phrasing
• Optimize titles for AI discovery
• Include contextual attributes (e.g., “great for travel”)

Webhook Integration

Setup Steps

1. Go to Integrations → Shopify → Webhooks
2. Click Enable Webhooks
3. Choose event types to monitor
4. Confirm delivery endpoint in GXO.dev

Supported Events

• Product updates
• Inventory changes
• Order creation events (optional)
• Error or failure alerts

🔔 Webhooks allow near-instant updates between Shopify and GXO.dev, ensuring your AI feeds stay current.

Performance Optimization

Sync Optimization

• Use incremental sync for large catalogs
• Monitor API usage and adjust frequency
• Track sync duration and error rates

Data Quality

• Regularly audit product data
• Improve image quality and consistency
• Keep descriptions complete and accurate

Security and Privacy

Data Protection

• Encrypted data transmission
• Secure token management
• OAuth tokens stored using industry-standard encryption
• Regular internal audits

Access Control

• Role-based permissions
• Integration audit logs
• Token rotation and access expiration

Privacy Compliance

• GDPR: Right to deletion, transparent processing, retention policies
• CCPA: Customer data disclosure, opt-out mechanisms
• Privacy-first by design

Monitoring and Analytics

Connection Health

• Real-time connection status
• API latency and uptime monitoring
• Error detection and reporting

Alerts

• Email notifications for connection errors
• Dashboard alerts for degraded performance
• API quota warnings

Performance Metrics

Sync Performance

• Sync success/failure rates
• Average processing time per batch
• API request volume

Product Performance

• AI agent interactions
• Conversions and attributions
• GMV impact and growth trends

📈 See Analytics Dashboard Overview to monitor your performance in real time.

Best Practices

Before Connecting

1. Ensure product data is complete and high quality
2. Verify accurate pricing and inventory
3. Use clear, consistent categories and tags
4. Write descriptive, AI-friendly product copy

After Connecting

1. Verify initial sync completed successfully
2. Test AI discovery in AI Previews
3. Configure sync frequency and webhook alerts
4. Monitor analytics for early insights

Ongoing Maintenance

• Weekly sync and data health checks
• Regular title and image optimization
• Quarterly product catalog audits
• Update variants and tags as products evolve

Next Steps

Now that your Shopify store is connected:

• Configure Product Sync Settings
• Set Up Webhook Notifications
• Optimize Product Data
• Monitor Performance Analytics

Support and Resources

Getting Help

• Documentation: Comprehensive guides for every feature
• Support: Email support for all plans, priority for Pro+
• Community: Join our Discord Community
• Training: Video tutorials and webinars

Shopify Resources

• Shopify App Store
• Shopify Developer Docs
• Shopify Community
• Shopify Support

Connect your Shopify store to GXO.dev and bring your products into the age of AI-powered commerce. Every query becomes a chance for discovery.