# 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

| Parameter | Type | Required | Description |
|  --- | --- | --- | --- |
| `shopify_shop_name` | String | Yes | Your Shopify shop name (without .myshopify.com) |
| `shopify_access_token` | String | Yes | Admin API access token with required permissions |
| `api_version` | String | No | Shopify API version (defaults to 2025-01) |
| `product_sync_interval` | Number | No | How 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 Field | Jay Marketplace Field |
|  --- | --- |
| Title | Name |
| Variant SKU | Article number |
| Vendor | Brand |
| Tags (filtered) | Fit, Material, Gender |
| Variant price | Price |
| Compare at price | Original Price |
| Currency code | Currency |
| Variant title | Size |
| Available | Stock Count |
| Body HTML | Description |
| Handle | Slug |
| Images | Product Images |
| Product URL | Product 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](mailto:info@transfermedia.de).