Shopify Just Released a Claude Code Plugin — Build & Run a Store with AI (2026)

One Prompt, an Entire Shopify Store

I told Claude Code to set up a Shopify store. Watch what came out of one prompt: 5 coffee products with prices and descriptions, a 20% off discount code called LAUNCH20, a Featured collection containing all 5, sales channels published, and real product photos uploaded to each one.

Shopify just dropped the official AI Toolkit on April 9, 2026 — and this guide walks you through exactly how to use it, including the one gotcha that traps every developer who tries this for the first time.

Step 1: Create a Free Shopify Partner Account

Head to partners.shopify.com and click Become a Partner. Set up the account — it's free, takes 30 seconds, and gives you unlimited dev stores.

Step 2: Open the Dev Dashboard and Create a Dev Store

Inside the Partner Dashboard, click the toggle in the top-right corner to switch to the Dev Dashboard. From the left sidebar, pick Dev Stores, then click Create Dev Store and fill the form.

Once the store is created, you'll land inside an empty Shopify Admin. Currently there are zero products.

Step 3: Grab Your Store URL

You'll need the store URL in two upcoming commands, so grab it now. The format looks like:

your-handle.myshopify.com

The part before .myshopify.com is your store handle. Copy the full URL — you'll use it in 30 seconds.

Step 4: Verify the Shopify CLI

Open your terminal and check that the Shopify CLI is available:

shopify

If it's not installed, run:

npm install -g @shopify/cli@latest

Step 5: Authenticate the Dev Store

Now authenticate your store with the Shopify CLI. Type the following command, replacing your-handle with your actual store handle:

shopify store auth --store your-handle.myshopify.com --scopes write_products,write_discounts,write_publications,read_publications,write_inventory,read_inventory

The browser opens automatically. Click Install once and you're authenticated. Auth caches automatically — every later command just works.

Step 6: Register the Shopify AI Toolkit Marketplace in Claude Code

Open Claude Code in any folder. Run this to register Shopify's official marketplace:

/plugin marketplace add Shopify/shopify-ai-toolkit

Step 7: Install the Shopify Plugin

Run:

/plugin install

Use the right arrow key to navigate to the Marketplaces tab, then arrow down to select Shopify AI Toolkit. Choose Browse plugins. There's only one official plugin from Shopify — that's shopify-plugin.

Pick the user scope so it's available across every project. Once installed, 18 official Shopify skills are now loaded into your agent.

Step 8: The Wow — One Prompt for the Whole Store

Now the magic. Give Claude Code this one prompt (replace the store handle with yours):

Using the Shopify AI toolkit, set up my development store at your-handle.myshopify.com. Create 5 coffee products with realistic single-origin names like "Ethiopia Yirgacheffe", "Colombia Supremo", "Sumatra Mandheling", "Guatemala Antigua", "Kenya AA". Prices between $14.99 and $24.99. Each product gets a one-sentence description. Then create a 20% off discount code called "LAUNCH20" applying to all items, and a "Featured" collection containing all 5 products.

Claude Code recognises the toolkit, runs through a multi-step workflow, and starts using the Shopify CLI. The agent will ask for confirmation at each major step — accept each one as it goes.

Heads-Up: Auth Callback Mid-Flow

During the flow, you may see Claude Code report:

The auth flow needs a browser session that I cannot drive from here — the OAuth callback failed mid-flow.

Don't worry. Copy the URL Claude Code provides and run it yourself in the browser to complete authorization. Then tell Claude Code "please continue" — once you confirm authorization, it picks back up using the cached CLI.

Result after a couple of confirmations: 5 products created (with price, vendor, product type, description), the LAUNCH20 discount code created, the Featured collection created, all 5 products added to that collection.

Step 9: The Gotcha — Storefront Still Empty

Visit your storefront (your-handle.myshopify.com) and refresh. Everything looks empty — you'll still see placeholder products from the theme. This is where every other tutorial leaves you stuck.

The placeholder products you see are not real — they're the theme's default placeholders. Your actual products exist in the database, but they aren't published to any sales channel yet. Go to the Shopify Admin's Products page and look at the Channels column — every product shows 0.

That's the gotcha nobody tells you about. Products created via the API are saved but not auto-published. You have to call publishablePublish explicitly.

Step 10: Three Fixes in One Prompt

Back in Claude Code, submit this second prompt:

Using the Shopify AI toolkit on your-handle.myshopify.com:
(1) publish all 5 of my coffee products to the Online Store sales channel using publishablePublish so they show on the storefront,
(2) add all 5 products to the existing "Home page" collection (handle: home-page) so the Horizon theme renders them on the homepage,
(3) attach a high-quality free Unsplash coffee photo to each product as the primary image using productCreateMedia.

The toolkit publishes all 5 products to the Online Store sales channel. Then it fetches real Unsplash URLs and attaches each one as a primary image. All three tasks verified done.

Refresh the storefront — and there it is. All 5 coffee products with real photos, real prices, real names. The placeholder t-shirts are gone.

Why the Toolkit Works When Hand-Coded GraphQL Doesn't

Everything you just saw — store creation, product import, discount codes, collections, sales channel publishing, image upload — used to take 30 minutes of clicking around the Admin or copy-pasting GraphQL into Postman.

Now it's two prompts and 90 seconds. The reason it works: the toolkit knows exactly which mutations to call, which fields to fill, and it doesn't hallucinate, because it queries Shopify's live schema in real time.

What You Just Learned

How to install the official Shopify AI Toolkit in Claude Code with two commands
How to build a real store from a single prompt
How to fix the sales-channel publishing gotcha that traps every developer the first time

The toolkit ships with 18 skills — this guide used about 5 of them. The next step is using the same toolkit to build a custom Shopify app extension. That's coming in a follow-up tutorial.

Useful Links

Shopify Partners signup: partners.shopify.com
Shopify AI Toolkit GitHub: github.com/Shopify/shopify-ai-toolkit
Claude Code download: claude.com/code