Last updated

Shopify Product Management

The Jay marketplace allows you to connect your existing Shopify store directly, enabling you to manage your product catalog without needing to manually add products. This integration simplifies the process of keeping your product data up-to-date and synchronized with your Shopify store.

Overview

The Shopify Product Import Integration automatically fetches your product catalog from Shopify and makes it available in the Jay marketplace for association with content. This integration provides real-time access to your product data, including:

  • Product details (names, descriptions, SKUs)
  • Images and media
  • Pricing information (regular and sale prices)
  • Inventory levels and availability
  • Product variants (sizes, colors, styles)
  • Collections and categorization

Integration Process

Content Curation Phase

  1. Content gets annotated to identify possible items for product matching
  2. This can be done scene-by-scene or using timecode-based annotations
  3. When content curation is finished, the system switches to product curation mode

Product Curation Phase

During this phase, you can:

  • Select products from your Shopify store to associate with specific episodes or scenes
  • The Jay marketplace automatically pulls in all product details directly from Shopify
  • Preview how products will appear alongside the content
  • Adjust product positioning and presentation
Import products in the curator from Shopify

Integration Requirements

Shopify Store Configuration

Your Shopify store must have:

  1. Admin API Access Token with the following permissions:

    • read_products - Access product details, variants, and images
    • read_inventory - Access inventory levels
    • read_product_listings - Access published product information
  2. Product Setup:

    • Products must be properly configured in Shopify with complete information
    • Product variants should have clear, distinguishable attributes
    • Product images should meet recommended quality standards (minimum 1000x1000px)

Required Configuration Parameters

ParameterTypeRequiredDescription
shopify_shop_nameStringYesYour Shopify shop name (without .myshopify.com)
shopify_access_tokenStringYesAdmin API access token with required permissions
api_versionStringNoShopify API version (defaults to 2025-01)
product_sync_intervalNumberNoHow often to sync products (in minutes, defaults to 60)

Technical Specifications

API Integration

  • Uses Shopify Admin API version 2025-01
  • GraphQL-based API for efficient data retrieval
  • Supports product collections and smart collections
  • Handles paginated responses for large catalogs

Data Synchronization

  • Initial full catalog import
  • Regular incremental updates based on configured sync interval
  • Real-time inventory level updates (if enabled)
  • Automatic detection of new, updated, and deleted products

Product Data Mapping

The integration maps Shopify fields to Jay marketplace product schema:

Shopify FieldJay Marketplace Field
TitleName
Variant SKUArticle number
VendorBrand
Tags (filtered)Fit, Material, Gender
Variant pricePrice
Compare at priceOriginal Price
Currency codeCurrency
Variant titleSize
AvailableStock Count
Body HTMLDescription
HandleSlug
ImagesProduct Images
Product URLProduct link

Prerequisites for Integration

  1. Shopify Store (any plan that provides API access)
  2. Well-structured product catalog with complete information
  3. Admin API Access Token with required permissions
  4. Jay Marketplace onboarding completed

Benefits

  1. Real-time product data: Always up-to-date pricing and inventory
  2. Reduced manual work: No need to duplicate product data entry
  3. Consistent product information: Single source of truth for product details
  4. Quick implementation: Fast setup with minimal configuration

Training and Support

You will receive comprehensive training on how to use the Shopify integration during the onboarding process. This includes:

  • How to browse and select products from your Shopify catalog
  • Best practices for product-content association
  • Troubleshooting common integration issues
  • Optimizing product presentation for conversion

Sales

For any questions or inquiries, please contact the Jay Sales Team.