​
Quick Setup Guide

Follow these simple steps to add AI-powered search to your Shopify store:

​
Step 1: Install the App

  1. Submit a support ticket with subject line “Shopify Integration” to Marqo
  2. Marqo will send an install link to the custom Shopify app distribution
  3. Install the custom app in Shopify following the support instructions

​
Step 2: Choose Your Search Model

  1. Select your model:
    • Generalized Ecommerce - Best for most stores
    • Fashion - Optimized for clothing and accessories
  2. We’ll automatically spin up and configure your search index with optimized settings
  3. Wait for setup to complete (usually 2-3 minutes)

​
Step 3: Connect Your Marqo Account

  1. Enter your Marqo API key when prompted
  2. Click “Validate & Connect”

​
Step 4: Sync Your Products

  1. Click “Sync All Products” to import your product catalog
  2. Large catalogs may take a few hours to complete
  3. New products (incuding updates, deletions, and additions) will sync automatically going forward

​
Step 5: Configure Collections (Optional)

  1. Choose Which Collections to Enhance:
    • Select specific collections to replace with AI-powered search
    • Leave others using Shopify’s default search if preferred
  2. Collection-Specific Settings:
    • Configure how products are filtered within each collection
    • Set collection-specific search behavior and sorting

​
Step 6: Customize Your Search Results (Optional)

  1. Choose a Product Card Style:
    • Modern Grid Theme - Clean card-based layout with hover effects
    • Classic List Theme - Traditional row-based product listings
    • Custom Templates - Edit HTML templates and add your own styling
  2. Customize Product Cards:
    • Edit what information appears on each product card
    • Adjust card layout, colors, and fonts
    • Configure grid columns and spacing for different screen sizes
    • Add custom CSS for complete visual control
  3. Layout & Sorting Options:
    • Set default sort options (relevance, price, newest, custom)
    • Configure responsive breakpoints for mobile/tablet/desktop
    • Choose which collections to enhance with AI search
  4. Preview all changes before going live

​
Step 7: Adding Additional Product Attributes (Optional)

Want to enhance your search with data from third-party providers? Use the Marqo API to update existing products with additional attributes. Common third-party integrations:
  • Review platforms: Customer ratings and review counts
  • Web analytics: Page views and conversion data
  • Email marketing tools: Engagement scores and customer segments
Setting up data sync: Most third-party platforms provide APIs or webhook systems that can automatically notify your system when data changes. Here’s how the integration typically works:
  1. Initial Data Import: First, pull all existing data from your third-party platforms using their APIs to populate your Marqo index with historical ratings, view counts, and engagement scores
  2. API Keys: Obtain API credentials from your third-party platform
  3. Webhook Setup: Configure webhooks to trigger when data updates (new reviews, page view changes, etc.)
  4. Data Processing: Create a script or service that receives the webhook, processes the data, and calls Marqo’s update API
  5. Scheduling: For platforms without webhooks, set up scheduled jobs (daily/hourly) to pull fresh data via their API
Example workflow: When a customer leaves a new review, your review platform sends a webhook to your server, which then updates the product’s rating in Marqo using the code below. 
import marqo

# Initialize Marqo client
mq = marqo.Client("https://api.marqo.ai", api_key="your_api_key")
# Update existing products with third-party data using product SKU
updated_products = [
    {
        "_id": "SKU-ABC123",  # Use product SKU as the ID
        "review_rating": 4.8,
        "review_count": 127,
        "page_views": 2450,
    },
    {"_id": "SKU-XYZ789", "review_rating": 4.2, "review_count": 89, "page_views": 1200},
]
# Update the documents with new attributes
mq.index("your_index_name").update_documents(updated_products)

​
Step 8: You’re Done!

Your customers can now enjoy faster, smarter search results. The app automatically replaces your store’s search functionality with AI-powered recommendations.

​
Need Help?

Contact our support team if you encounter any issues during setup.