# Shopify Integration

> Sync your Shopify product catalog into a Reaktly knowledge base.

URL: https://docs.reaktly.com/docs/integrations/shopify

## Overview

The Shopify integration imports your product catalog and keeps it up to date, so the AI answers questions about products, pricing, and availability from live data.

## Setup

1. Install the Reaktly app on your Shopify store (Reaktly provides the install link; the app requests product read access).
2. Authorize the connection — Shopify redirects back to Reaktly with an access token.
3. Reaktly imports your catalog into the selected knowledge base.
4. Product changes arrive through webhooks; the knowledge base follows within minutes.

No manual ingestion code is involved — Shopify events land on Reaktly's webhook endpoint.

## What gets synced

| Field | How the AI uses it |
|---|---|
| Title | Answers "do you have …?" |
| Description | Product details, cleaned of HTML |
| Vendor | Brand questions |
| Tags | Category and use-case questions |
| Price | Price questions |
| SKU | Exact product identification |
| Inventory (`inStock`, `quantityAvailable`) | Availability answers |
| Images | Product visuals in answers |

Behind the scenes each product is ingested as a `PRODUCT` source with this data in `data.sourceData` — the same shape you would send yourself via the [Ingestion API](/docs/api-reference/ingestion).

## Keeping the catalog in sync

The integration reacts to Shopify product events (`products/create`, `products/update`) and re-ingests the affected product. Items deleted in Shopify are removed from the knowledge base by the sync's cleanup step.

## Troubleshooting

| Symptom | Check |
|---|---|
| Products missing | The product is published to the sales channel the app can read |
| Stale price or stock | The product update webhook arrived — check the integration's recent activity |
| Wrong answers about variants | Put variant-level detail into the product description; the first variant's price and the summed inventory are what the catalog sync captures |