Skip to main content
Better Data provides a robust, production-ready integration for Shopify using the Storefront API. This allows any AI to search your catalog, check stock, and create draft orders.

​
Prerequisites

  • A Shopify store
  • A Storefront Access Token (found in App settings -> Manage private apps)
  • The @betterdata/commerce-gateway package installed

​
Setup

​
1. Initialize the Shopify Backend

import { ShopifyBackend } from '@betterdata/commerce-gateway/shopify';

const shopify = new ShopifyBackend({
  domain: process.env.SHOPIFY_DOMAIN!, // e.g. mystore.myshopify.com
  accessToken: process.env.SHOPIFY_STOREFRONT_TOKEN!,
  apiVersion: '2024-01',
});

​
2. Connect to the Gateway

const gateway = new LLMGateway({
  backends: {
    products: shopify,
    cart: shopify,
    orders: shopify,
  },
});

​
Features

Supports natural language searching, filtering by collections, and tag-based discovery.

​
Real-time ATP

The backend automatically queries Shopify’s internal inventory levels to provide accurate “Available to Promise” quantities to the LLM.

​
Draft Orders

When a user is ready to checkout, the gateway creates a Shopify Draft Order and provides a secure link for the user to complete payment on your Shopify-hosted checkout page.

​
Configuration

interface ShopifyConfig {
  domain: string;
  accessToken: string;
  apiVersion?: string;
  // Optional: Only include specific collections
  collections?: string[];
  // Optional: Map custom metafields to product attributes
  metafieldMap?: Record<string, string>;
}

​
Troubleshooting

  • Permissions: Ensure your Storefront Access Token has unauthenticated_read_product_listings and unauthenticated_write_checkouts scopes.
  • Throttling: For very high traffic, Shopify might rate-limit the Storefront API. Consider using the Better Data Cloud for managed caching and shielding.