AIFDS 0.2 · beta

Ecommerce — Collections

Explain how you group products, why a shopper should care, and which filters or merchandising notes matter most for the collection.

Schema: collections.schema.json Industry overview: /industries/ecommerce/

Fields

Capture the merchandising intent, featured products, and evidence supporting this collection.

Field Description
template String identifier; always ecommerce_collection. Required.
version Semantic version for the document. Required.
updated_at ISO 8601 timestamp for the last refresh. Required.
collection Metadata about the collection: slug, title, tagline, optional image, and description.
merchandising Describes the strategy (seasonal, persona-based, price tier) and the decision logic powering the listing.
filters Array of filters with label, key, and optional default. Helps agents replicate the browsing options.
featured_products Array of product references containing product_id, name, url, price, and highlight copy.
evidence Supporting proof such as editor notes, reviews, or expert picks that explain why the collection matters.
actions Next steps like shop, compare, or contact a stylist. Includes type, label, url, and optional owner.
related_collections Array linking to complementary collections with title and url.
Example schema — handsomecalavera.com 
{
  "template": "ecommerce_collection",
  "version": "1.0.0",
  "updated_at": "2024-02-15T14:00:00Z",
  "collection": {
    "slug": "everyday-carry",
    "title": "Everyday Carry Essentials",
    "tagline": "Streamlined kits for commute and travel.",
    "description": "Curated leather goods sized for notebooks, passports, and laptops. Built to patina with daily use.",
    "url": "https://www.handsomecalavera.com/collections/everyday-carry",
    "image": "https://www.handsomecalavera.com/assets/collections/everyday-carry.jpg"
  },
  "merchandising": {
    "strategy": "Persona — commuters and remote workers",
    "curator": "Product team",
    "logic": "Featured items balance quick-access storage, minimal weight, and RFID shielding."
  },
  "filters": [
    { "label": "Color", "key": "color", "options": ["chestnut", "espresso", "obsidian"] },
    { "label": "Device fit", "key": "device_fit", "options": ["13-inch laptop", "tablet", "passport"] },
    { "label": "Availability", "key": "availability", "options": ["ready-to-ship", "made-to-order"], "default": "ready-to-ship" }
  ],
  "featured_products": [
    {
      "product_id": "HC-BAG-017",
      "name": "Calavera Commuter Satchel",
      "url": "https://www.handsomecalavera.com/products/commuter-satchel",
      "price": {
        "currency": "USD",
        "amount": 325
      },
      "headline": "Slim silhouette, holds a 15\" laptop and notebook.",
      "hero_image": "https://www.handsomecalavera.com/assets/products/commuter-satchel.jpg"
    },
    {
      "product_id": "HC-WLT-004",
      "name": "Signal Shield Passport Wallet",
      "url": "https://www.handsomecalavera.com/products/passport-wallet",
      "price": {
        "currency": "USD",
        "amount": 98
      },
      "headline": "RFID protection with boarding pass sleeve.",
      "hero_image": "https://www.handsomecalavera.com/assets/products/passport-wallet.jpg"
    }
  ],
  "evidence": [
    {
      "type": "press",
      "title": "Featured in Carryology's Best Everyday Bags",
      "url": "https://www.carryology.com/bags/handsome-calavera",
      "summary": "Highlighted for sustainability and repair program."
    },
    {
      "type": "review",
      "title": "Customer rating",
      "value": "4.9 / 5 average across 218 reviews"
    }
  ],
  "actions": [
    {
      "type": "shop",
      "label": "Shop everyday carry",
      "url": "https://www.handsomecalavera.com/collections/everyday-carry",
      "availability": "online"
    },
    {
      "type": "consult",
      "label": "Book a gear fitting",
      "url": "https://www.handsomecalavera.com/pages/consult",
      "availability": "appointment",
      "owner": "[email protected]"
    }
  ],
  "related_collections": [
    { "title": "Travel duo sets", "url": "https://www.handsomecalavera.com/collections/travel-sets" },
    { "title": "Notebook covers", "url": "https://www.handsomecalavera.com/collections/journals" }
  ]
}
Copy & paste template 
{
  "template": "ecommerce_collection",
  "version": "1.0.0",
  "updated_at": "YYYY-MM-DDThh:mm:ssZ",
  "collection": {
    "slug": "YOUR-COLLECTION-SLUG",
    "title": "Collection title",
    "tagline": "Short promise for the shopper.",
    "description": "Describe what the visitor will find and why it matters.",
    "url": "https://www.YOUR-DOMAIN.com/collections/YOUR-COLLECTION-SLUG",
    "image": "https://www.YOUR-DOMAIN.com/path-to-collection-image.jpg"
  },
  "merchandising": {
    "strategy": "Persona / season / campaign alignment",
    "curator": "Team or role responsible",
    "logic": "Explain how items earn a spot."
  },
  "filters": [
    { "label": "Filter name", "key": "filter_key", "options": ["value-1", "value-2"] }
  ],
  "featured_products": [
    {
      "product_id": "SKU-OR-UNIQUE-ID",
      "name": "Product name",
      "url": "https://www.YOUR-DOMAIN.com/products/PRODUCT-SLUG",
      "price": { "currency": "USD", "amount": 0 },
      "headline": "Quick benefit statement.",
      "hero_image": "https://www.YOUR-DOMAIN.com/path-to-product.jpg"
    }
  ],
  "evidence": [
    { "type": "review", "title": "Proof name", "value": "Metrics or quote", "url": "https://link-if-applicable" }
  ],
  "actions": [
    { "type": "shop", "label": "Primary action label", "url": "https://www.YOUR-DOMAIN.com/collections/YOUR-COLLECTION-SLUG", "availability": "online" }
  ],
  "related_collections": [
    { "title": "Related collection", "url": "https://www.YOUR-DOMAIN.com/collections/RELATED" }
  ]
}