Home/Docs/Integrations

Shopify Overview

What the Shopify integration does, what data syncs, and what stays AMS-only. (Beta)

The Shopify integration is currently in Beta. Core sync flows are stable and running with real merchants; expect rapid iteration as we expand the feature.

What It Does

The Shopify integration connects your AMS product catalog with your Shopify store. Once connected, you can:

  • Push AMS products to Shopify to list them in your online store
  • Import Shopify products into AMS to manage them alongside your other inventory
  • Push changes you make in AMS to Shopify automatically or on demand
  • Automatically detect and resolve differences between the two catalogs
  • Keep stock quantities in sync — AMS pushes live stock to your Shopify storefront, minus any wholesale commitments, so you don't oversell

The integration uses Shopify's Admin API with a custom app that you create in your Shopify store. Your access token is encrypted at rest using AES-256-GCM and never leaves the server.

Where to Find It

Go to My Business → Integrations to see the Integrations hub. Click the Shopify tile to open the dedicated Shopify detail page, which is organized into four tabs:

  • Overview — connection status, Product Stock Sync health, and the Full Sync And Compare button.
  • Push Log — the last 30 days of stock pushes, with success / failure / retry status and the exact quantity sent for every variant.
  • Settings — pause / resume stock sync, change the inventory location, and configure the Sold-Out Override.
  • Setup Wizard — the step-by-step Shopify custom-app setup. See Shopify Setup for details.

What Syncs

The following data is compared and synchronized between AMS and Shopify:

Product Fields

  • Name / Title — AMS product name maps to Shopify product title
  • Description — maps to Shopify body HTML
  • Vendor — syncs directly
  • Category — maps to Shopify product type
  • Option Names — e.g., Size, Color, Style
  • Status — AMS active/inactive status
  • Shopify Status — Shopify-specific listing status (Active, Draft, Archived, Unlisted); separate from AMS active/inactive

Variant Fields

  • SKU — syncs directly, used for matching
  • Retail Price — AMS retail_price maps to Shopify variant price
  • Option Values — e.g., "Small", "Blue"

Stock Quantities

  • AMS pushes on-hand stock minus wholesale commitments to your Shopify variant Available quantity on every change (sale, adjustment, ship, etc.).
  • Pushes run on a short interval. You can also click Push pending now on the Overview tab to flush the queue immediately.
  • Stock conflicts (AMS and Shopify disagree on the on-hand count) surface in the sync compare flow alongside field and variant conflicts — resolve them inline or with Accept-All bulk actions.

Images

  • Product images sync bidirectionally
  • Shopify images are downloaded and stored in AMS during sync
  • AMS images are pushed to Shopify via public Storage URLs
  • Variant-image assignments are preserved where possible

What Doesn't Sync

These fields are AMS-only and have no Shopify equivalent:

  • COGS, Material Cost, Labor — internal cost tracking
  • Markup, Wholesale Pricing — AMS pricing worksheet
  • Commission Rate — retailer-specific
  • Retail Listed — AMS portal concept
  • Consignment Stock — managed per-retailer in AMS
  • Components / Bill of Materials — AMS manufacturing data

How Linking Works

Products are linked between AMS and Shopify using internal IDs stored on the AMS product record (shopify_product_id). Once linked, products stay connected across all future syncs. Linking happens automatically during the sync process:

  • Products matched by shopify_product_id (previously linked)
  • Products matched by SKU (first sync)
  • Unmatched products can be pushed or imported

Sync Status

Each linked product shows a sync status badge:

  • Synced (green) — product is linked and has no pending changes
  • Out of Sync (amber) — changes were made in AMS but not pushed to Shopify
  • Sync Error (red) — last sync attempt failed

You can see sync status in the product list table and on the product detail page header.