---
spec_name: "Shopify Agentic Commerce Setup"
description: "A spec to guide Claude in making a Shopify store agent-ready by activating the correct sales channel, structuring product data, and implementing the necessary JSON-LD schema."
---

## Goal

Configure a Shopify store for Agentic Commerce, ensuring its products are discoverable and transactable by AI assistants like ChatGPT, Google AI, and Microsoft Copilot.

## Context

This task is based on Shopify's new "Agentic Storefronts" sales channel, which uses the Universal Commerce Protocol (UCP) to syndicate product catalogs to AI platforms. The key to success is clean, structured data.

## Execution Steps

### Step 1: Provide the Activation Checklist

Present the following checklist to the user as the core workflow. These are the manual steps they will need to take within their Shopify admin.

```text
### Shopify Agent-Ready Checklist

1.  **Activate Sales Channel:**
    - Go to Shopify Admin > `Settings` > `Sales channels`.
    - Click `Add sales channel`.
    - Search for and add "Agentic Storefronts".

2.  **Verify Product Sync:**
    - Open the new Agentic Storefronts channel dashboard.
    - Confirm that your products are syncing without errors. Address any data issues flagged by Shopify.

3.  **Implement Product Schema:**
    - Go to `Online Store` > `Themes` > `...` > `Edit code`.
    - Open the `product.liquid` template file.
    - Paste the JSON-LD schema provided in Step 2 of this spec into the file.

4.  **Structure Key Product Descriptions:**
    - Identify your top 5-10 selling products.
    - Edit their descriptions to include clear, structured information that an AI can parse.
```

### Step 2: Provide the JSON-LD Schema

Provide the user with this exact, copy-pasteable JSON-LD schema block. Instruct them to place it within their `product.liquid` theme file.

```html
<script type="application/ld+json">
{
  "@context": "https://schema.org/",
  "@type": "Product",
  "name": "{{ product.title | escape }}",
  "image": "{{ product.featured_image | image_url: width: 600 }}",
  "description": "{{ product.description | strip_html | strip_newlines | escape }}",
  "sku": "{{ product.selected_or_first_available_variant.sku }}",
  "brand": {
    "@type": "Brand",
    "name": "{{ shop.name | escape }}"
  },
  "offers": {
    "@type": "Offer",
    "url": "{{ product.url | within: collection }}",
    "priceCurrency": "{{ cart.currency.iso_code }}",
    "price": "{{ product.price | money_without_currency | replace: ',', '' }}",
    "availability": "https://schema.org/{{ product.available | ternary: 'InStock', 'OutOfStock' }}",
    "priceValidUntil": "{{ 'now' | date: '%s' | plus: 31536000 | date: '%Y-%m-%d' }}"
  }
}
</script>
```

### Step 3: Offer to Rewrite a Product Description

Prompt the user to provide one of their current product descriptions. Then, rewrite it to be "agent-friendly" using a structured format. Use this template:

**Example Transformation:**

*   **Before:** "Our classic leather wallet. It's high quality and has lots of space for cards and cash. Brown color."

*   **After (Agent-Friendly):**
    "The Classic Bifold is a full-grain leather wallet designed for the minimalist who values durability and style.

    **Who It's For:**
    Ideal for professionals, travelers, and anyone seeking a slim, organized wallet that develops a rich patina over time.

    **Key Features:**
    - Holds up to 10 cards and flat bills.
    - RFID-blocking technology to protect your information.

    **Materials & Dimensions:**
    - Material: 100% Full-Grain Leather
    - Dimensions: 4.5" x 3.5" (closed)"

When you receive a description, apply a similar structured format.