Sync Products
Import your product catalog so your AI agent can recommend products, answer pricing questions, and handle shopping cart interactions. Access it from Admin > Sync Products (Shopify) or Admin > Upload Products (non-Shopify) in your admin panel.
Shopify Product Sync
If you're a Shopify tenant, products are synced directly from your Shopify store.
How It Works
- Go to Admin > Sync Products
- Click Sync Products Now
- Products are imported from your Shopify catalog
- Each product becomes searchable by your AI agent
What Syncs
- Product titles and descriptions
- Prices and compare-at prices
- Variants (size, color, etc.)
- Images and media
- Categories and tags
- SKUs and inventory status
Re-syncing
Run the sync again anytime to pick up new or updated products. The sync replaces existing product data with the latest from Shopify, so your AI always has current inventory.
Upload Products (Non-Shopify)
If you're not on Shopify, upload your product catalog via CSV or Excel file using the 3-step wizard.
How It Works
| Step | Description |
|---|---|
| 1. Select | Choose a CSV or Excel file, validates required columns |
| 2. Map | Configure media URL and numeric field mappings |
| 3. Upload | Products are imported and indexed for search |
Step 1: File Selection
- Drag and drop or browse for a CSV/Excel file
- The wizard validates that required columns exist
- Preview shows first 3 rows of data
- Optionally enable Fresh Start to delete existing products first
- Click Next: Configure Mapping
If required columns are missing, an error is displayed listing them.
Step 2: Field Mapping
Configure how optional fields map to your data:
| Field | Description |
|---|---|
| Media URL | Select column containing image/video/audio URLs |
| Numeric Field 1-3 | Select columns with numeric values for range queries |
| Also label as | Abbreviations and synonyms for the column name |
The dropdown only shows columns containing numeric values. If your CSV headers use the pattern column_name (numeric1), mappings are auto-detected.
What is "Also label as"?
When you map a column to a numeric field, the column name becomes the primary label automatically. The system also auto-generates common abbreviations for well-known terms like "square feet", "bedrooms", "mileage", etc.
The Also label as field lets you add additional abbreviations that users might type:
| Column Mapping | Auto-Generated | Also Label As | All Queries Supported |
|---|---|---|---|
| square_feet -> Numeric 1 | sqft, sq ft | ft2 | "over 1000 square feet", "over 1000 sqft", "over 1000 ft2" |
| bedrooms -> Numeric 2 | bedroom, bed, br | bdrm | "3 bedrooms", "3 bed", "3 bdrm" |
| mileage -> Numeric 1 | miles, mi | odometer | "under 50000 mileage", "under 50000 miles", "under 50000 odometer" |
You only need to add abbreviations that aren't auto-generated.
Step 3: Upload Results
After clicking Upload Products, the wizard shows:
- Total rows processed
- Valid records inserted
- Any validation errors encountered
- Batch name for the upload
Required Columns
| Column | Description |
|---|---|
| title | Product name |
| url | Product page URL |
| price | Numeric price value |
| category | Product category |
Optional Columns
| Column | Description |
|---|---|
| media_url | Image, video, or audio URL |
| Any other columns | Automatically become searchable keywords |
CSV Example
Click Download example CSV to get a sample file showing the expected format.
Required field:
| Field | Description |
|---|---|
| title | Product title including variants — use the format Product Name - Option1 / Option2 (e.g., Classic Leather Jacket - Black / M) |
Optional fields:
| Field | Description |
|---|---|
| id | Unique product identifier |
| url | Product page URL |
| price | Product price |
| category | Product category for grouping |
| description | Product description |
| media_url | Image URL |
| sku | Stock keeping unit |
| tags | Comma-separated tags |
| vendor | Product vendor/brand |
| available_for_sale | true or false |
| compare_at_price | Original price before discount |
Variants of the same product share the base title and differ by the options after the dash (e.g., - Black / M vs - Brown / L).
Fresh Start Option
Enable Fresh Start to delete all existing uploaded products before uploading new ones. This:
- Removes all products from previous uploads
- Preserves crawled website content
- Useful for complete catalog replacements
Batch Management
Products are grouped by batch name (derived from filename):
- Re-uploading with the same filename replaces existing products
- Use different filenames to maintain separate product sets
Best Practices
- Keep your catalog updated — Re-sync or re-upload regularly so the AI has current inventory
- Use descriptive titles — Include key details in product titles for better search
- Map numeric fields — Enable range queries like "under $50" or "3 bedrooms"
- Download the example first — Use the example CSV to see the expected format before creating your own
- Use labeled CSV headers — Include
(numericN)in column names (e.g.,square_feet (numeric1)) for auto-detection
Related Pages
- Shopping Carts - Manage customer shopping carts
- Draft Orders - View orders from AI checkout
- Chunks & Products - Understand vectors and structured data