> ## Documentation Index
> Fetch the complete documentation index at: https://docs.replit.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Connect Shopify

> Connect Shopify so Agent can provision a Shopify store, build a custom storefront, and manage your products and inventory from inside Replit.

export const WistiaEmbed = ({videoId, title = "Wistia video", playerColor = "FF0000", controlsVisibleOnLoad = false}) => {
  if (!videoId) {
    return null;
  }
  const url = "https://fast.wistia.net/embed/iframe/" + videoId + "?seo=false&playerColor=" + playerColor + "&controlsVisibleOnLoad=" + controlsVisibleOnLoad;
  return <Frame>
      <iframe src={url} title={title} allow="autoplay; fullscreen" allowFullScreen></iframe>
    </Frame>;
};

<WistiaEmbed videoId="d3o9gwwtiw" title="Connect Shopify and build a storefront with Agent" />

With the Shopify connector, Agent provisions a Shopify store, builds a custom storefront against it, and manages your products and inventory, all in one conversation, with no API keys. Agent recommends Shopify whenever you describe selling a physical good, and you only visit Shopify to go live. From first prompt to real orders is about ten minutes.

<Note>
  For a step-by-step walkthrough, follow [Build a Shopify storefront](/build/ecommerce-store).
</Note>

## What you can build

* Custom-designed storefronts for physical products
* Branded merch and apparel stores
* Direct-to-consumer shops with carts and checkout
* Catalog and inventory tools backed by your Shopify store
* Product landing pages that sell a single hero item

## Examples

<Frame caption="Ember & Oak: a hand-poured soy candle store, built in the tutorial">
  <img src="https://mintcdn.com/replit/HIUZSogml1gclscE/images/build-examples/ember-and-oak-candles.png?fit=max&auto=format&n=HIUZSogml1gclscE&q=85&s=f22b2300c152ac6555dd5edb8dfbcc1f" alt="The Ember & Oak candle storefront: a warm cream-and-amber design with a lit-candle hero and the headline 'Light that feels like home'" width="3452" height="1978" data-path="images/build-examples/ember-and-oak-candles.png" />
</Frame>

<Frame caption="Petals & Purl: a hand-knitted yarn flower store">
  <img src="https://mintcdn.com/replit/HIUZSogml1gclscE/images/build-examples/petals-and-purl.png?fit=max&auto=format&n=HIUZSogml1gclscE&q=85&s=8c704f8af42e1d0c010445cdf2eaee36" alt="The Petals & Purl storefront: a cozy hand-knitted yarn flower shop with the headline 'Blooms that last a lifetime'" width="1291" height="740" data-path="images/build-examples/petals-and-purl.png" />
</Frame>

## How it works

<Steps>
  <Step title="Describe your store">
    Tell Agent what you want to sell. It recommends Shopify for physical goods, even if you don't name it.

    <Frame>
      <img src="https://mintcdn.com/replit/pRYYKFsTVxh8-e6X/images/replitai/shopify/describe-your-store.png?fit=max&auto=format&n=pRYYKFsTVxh8-e6X&q=85&s=b25c3bc8ff45c1bc509a10f60be294bd" alt="The Replit prompt box with a candle store prompt typed in" width="1440" height="900" data-path="images/replitai/shopify/describe-your-store.png" />
    </Frame>
  </Step>

  <Step title="Agent provisions a store">
    A development store is created (about ten seconds) under Replit's Shopify Partner account, the Replit Sales Channel app is installed, and the store is connected. No API keys; one store per app; password-protected until you claim it.

    <Frame>
      <img src="https://mintcdn.com/replit/pRYYKFsTVxh8-e6X/images/replitai/shopify/connect-shopify-store.png?fit=max&auto=format&n=pRYYKFsTVxh8-e6X&q=85&s=f10b41182863d7cb7afb5611d79bace1" alt="Replit Agent handing off to the Shopify skill, showing a 'Connect to Shopify' card with a Connect Shopify button" width="3452" height="1984" data-path="images/replitai/shopify/connect-shopify-store.png" />
    </Frame>
  </Step>

  <Step title="Agent builds and manages it">
    Agent designs the headless storefront and maintains products, variants, inventory, collections, and discounts.

    <Frame>
      <img src="https://mintcdn.com/replit/pRYYKFsTVxh8-e6X/images/replitai/shopify/add-product.png?fit=max&auto=format&n=pRYYKFsTVxh8-e6X&q=85&s=5f7a254e82ae13c1770632a9db916005" alt="A storefront product grid showing candle products with names and prices" width="3452" height="1978" data-path="images/replitai/shopify/add-product.png" />
    </Frame>
  </Step>

  <Step title="Go live on Shopify">
    Claim the store, choose a plan, set up payments, and launch when you're ready to sell.

    <Frame>
      <img src="https://mintcdn.com/replit/pRYYKFsTVxh8-e6X/images/replitai/shopify/claim-store.png?fit=max&auto=format&n=pRYYKFsTVxh8-e6X&q=85&s=317bdb5509beb15270c694087e3279fe" alt="Replit 'Claim your store' screen with a 'Claim store' button" width="3452" height="1978" data-path="images/replitai/shopify/claim-store.png" />
    </Frame>
  </Step>
</Steps>

## What Agent manages

Everything in the storefront and catalog is editable by chat.

| Area              | What Agent does                                                                                                                                                                                                                                                                                                                                 |
| ----------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Design            | Generates a headless front end from your guidance (no Liquid theme, no template library). Copy, layout, navigation, motion, and product pages are editable by chat, and you can explore directions with [Canvas](/references/design/canvas) variants. It's a real Replit project, so you can extend it with a blog, wishlist, or landing pages. |
| Products          | Create, update, and delete products and variants. Fields: title, description, type, vendor, tags, SKU, price, weight, options (size, color), images, and availability.                                                                                                                                                                          |
| Inventory         | Set and adjust stock per variant.                                                                                                                                                                                                                                                                                                               |
| Collections       | Group products into collections.                                                                                                                                                                                                                                                                                                                |
| Discounts         | Create a price rule plus a redeemable code.                                                                                                                                                                                                                                                                                                     |
| Publishing & sync | New products auto-publish to your storefront. Sync runs both ways: edits in your Shopify admin appear in the Replit preview, and Agent's changes appear in your Shopify admin.                                                                                                                                                                  |

## Replit and Shopify: who does what

| Replit owns                                                 | Shopify owns                                                |
| ----------------------------------------------------------- | ----------------------------------------------------------- |
| Storefront design and build                                 | Hosted checkout                                             |
| Catalog management by chat (products, inventory, discounts) | System of record for products, inventory, carts, and orders |
| Storefront hosting and deployment                           | Payments, identity verification (KYC), and payouts          |
| Canvas design variants                                      | Taxes, shipping, and fulfillment                            |
| Extending the app (blog, landing pages, and more)           | Multi-channel selling                                       |

Orders, refunds, payouts, and fulfillment are handled in your Shopify admin, not through Agent.

## Connection scope

* Available to all builders on all apps, connected in the conversation, with no Connectors-panel setup and no credentials.
* Scoped to one app: each app gets its own Shopify store.
* The store is a Replit-owned development store until you claim it; your email is shared with Shopify so you can claim it later.
* You can uninstall the Replit app from your Shopify admin at any time.

## Go live on Shopify

Going live happens on Shopify, not Replit. Ask Agent to start the Go Live flow, then complete these merchant-owned steps in your Shopify admin:

* **Claim the store** from the link in chat or the email Shopify sends. The link expires after 7 days. Claiming starts a free trial.
* **Choose a plan**: a [paid plan](https://www.shopify.com/pricing) is required to process live orders.
* **Set up payments**: activate [Shopify Payments](https://help.shopify.com/en/manual/payments/shopify-payments) or another provider and complete identity verification (KYC). Live capture works once the claiming account finishes KYC.
* **Configure [shipping](https://help.shopify.com/en/manual/shipping) and [taxes](https://help.shopify.com/en/manual/taxes).**
* **Connect a [custom domain](/build/add-custom-domain)** (optional) and remove the storefront password to open the store to buyers.

Checkout always redirects to Shopify-hosted checkout, so buyers pay on Shopify.

<Note>
  Payments, identity verification, taxes, shipping, and fraud checks stay on Shopify. Replit never collects merchant banking details, tax IDs, or other sensitive information.
</Note>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Setting up the Shopify store takes a while">
    Provisioning calls several Shopify APIs and can take a little time. Let Agent finish setup before asking it to build the storefront.
  </Accordion>

  <Accordion title="Checkout shows a password page during development">
    Development stores are password-protected until you go live, so checkout previews can land on a password page. This is expected, but the cart still works. Remove the password in Shopify only when you launch.
  </Accordion>

  <Accordion title="Checkout won't complete a real payment">
    Live capture requires the claiming Shopify account to finish payments setup and KYC. Until then, checkout redirects to Shopify but can't capture a payment. Complete KYC, or use an account that already has payments set up.
  </Accordion>

  <Accordion title="Agent says Shopify isn't connected for this app">
    Each store is scoped to one app. If you connected Shopify on a different app, ask Agent to set up a Shopify store for the current one.
  </Accordion>

  <Accordion title="Products don't appear on the storefront">
    A product is only visible once it's active and published. Agent auto-publishes products it creates; if one is missing, ask Agent to publish it, then refresh the preview.
  </Accordion>

  <Accordion title="The connection needs to reconnect after transfer">
    After you claim or transfer the store, Shopify may ask you to reauthorize the connection. Ask Agent to reconnect Shopify, and it restores access without losing your store.
  </Accordion>
</AccordionGroup>

## Related documentation

* [Build a Shopify storefront](/build/ecommerce-store): Step-by-step guide from a prompt to a published storefront
* [Add a custom domain](/build/add-custom-domain): Give your storefront a branded URL
* [Agent integrations](/references/integrations/overview): Replit-managed integrations and Agent services
* [Managing your connectors](/replitai/managing-connectors): Configure and manage connectors
* [Shopify Help Center](https://help.shopify.com/): Store setup, payments, and account management