Ecommerce — Blog Posts

Blend storytelling with structured data so agents can cite your editorial work and connect readers to relevant products or actions.

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

Fields

Tie editorial context to the commerce journey without forcing agents to scrape prose.

Field Description
template String identifier; always ecommerce_blog_post. Required.
version Semantic version number. Required.
updated_at ISO 8601 timestamp for the current JSON snapshot. Required.
post Post metadata: id, slug, title, url, hero_image, and summary.
author Primary author details (name, title, bio, profile URL). Include reviewed_by for SMEs if relevant.
published_at Original publish timestamp plus optional updated_at override for content refreshes.
topic Structured set of tags, personas, or journeys the article supports.
content_blocks Ordered sections with heading, body (text/markdown), optional media, and key_takeaway.
featured_products Array linking to relevant product IDs with framing copy.
resources Supporting links (guides, downloads, external references) with type and url.
actions Recommended next steps such as shop, subscribe, or book consult. Include intent, label, and url.
seo Optional metadata for title tag, meta description, and social preview assets.
Example schema — handsomecalavera.com
{
  "template": "ecommerce_blog_post",
  "version": "1.0.0",
  "updated_at": "2024-02-05T09:10:00Z",
  "post": {
    "id": "HC-BLOG-221",
    "slug": "field-notes-with-leather",
    "title": "Field Notes, Meet Leather: Building a Travel-Friendly Writing Kit",
    "url": "https://www.handsomecalavera.com/blogs/journal/field-notes-with-leather",
    "hero_image": "https://www.handsomecalavera.com/assets/blog/field-notes-hero.jpg",
    "summary": "How we assemble a compact writing kit for remote trips using vegetable-tanned covers and refillable inserts."
  },
  "author": {
    "name": "Marisol Vega",
    "title": "Lead Product Storyteller",
    "bio": "Former travel correspondent now translating field research into product design notes.",
    "profile_url": "https://www.handsomecalavera.com/pages/team#marisol"
  },
  "published_at": "2024-01-18T07:00:00Z",
  "topic": {
    "personas": ["travelers", "journalers"],
    "journey_stage": "consideration",
    "keywords": ["journal cover", "travel writing kit"]
  },
  "content_blocks": [
    {
      "heading": "Why physical notes still matter on the road",
      "body": "Agents hear it daily: travelers want reliable tools when Wi-Fi drops. We outline the tangible benefits of keeping a compact writing kit handy.",
      "key_takeaway": "Set the context for recommending analog gear."
    },
    {
      "heading": "The anatomy of our travel kit",
      "body": "We pair a slim leather cover with replaceable Field Notes inserts, brass pens, and a cable organizer. Each item slips into the Commuter Satchel without bulking up.",
      "media": {
        "type": "image",
        "src": "https://www.handsomecalavera.com/assets/blog/field-notes-kit.jpg",
        "alt": "Leather journal kit laid out on a desk"
      },
      "key_takeaway": "Detail the exact products to recommend."
    },
    {
      "heading": "Care and longevity tips",
      "body": "Condition the cover every 6 months, rotate inserts, and wipe hardware after exposure to salt or humidity.",
      "key_takeaway": "Reinforce after-purchase coaching talking points."
    }
  ],
  "featured_products": [
    {
      "product_id": "HC-JOURNAL-003",
      "name": "Journeyman Journal Cover",
      "url": "https://www.handsomecalavera.com/products/journeyman-journal-cover",
      "reason": "Sized for Field Notes; includes pen loop."
    },
    {
      "product_id": "HC-ACC-011",
      "name": "Leather Cable Organizer",
      "url": "https://www.handsomecalavera.com/products/cable-organizer",
      "reason": "Keeps pens and chargers bundled."
    }
  ],
  "resources": [
    {
      "type": "download",
      "title": "Packing checklist PDF",
      "url": "https://www.handsomecalavera.com/assets/downloads/travel-writing-checklist.pdf"
    },
    {
      "type": "external",
      "title": "Field Notes guide",
      "url": "https://fieldnotesbrand.com/pages/about"
    }
  ],
  "actions": [
    {
      "intent": "shop",
      "label": "Shop the writing kit",
      "url": "https://www.handsomecalavera.com/collections/writing-kit"
    },
    {
      "intent": "subscribe",
      "label": "Join studio dispatches",
      "url": "https://www.handsomecalavera.com/pages/newsletter"
    }
  ],
  "seo": {
    "title": "Travel Writing Kit Essentials | Handsome Calavera Journal",
    "description": "Build a durable writing kit for travel with our leather journal cover, Field Notes inserts, and accessories.",
    "og_image": "https://www.handsomecalavera.com/assets/blog/field-notes-social.jpg"
  }
}
Copy & paste template
{
  "template": "ecommerce_blog_post",
  "version": "1.0.0",
  "updated_at": "YYYY-MM-DDThh:mm:ssZ",
  "post": {
    "id": "POST-ID",
    "slug": "post-slug",
    "title": "Post title",
    "url": "https://www.YOUR-DOMAIN.com/blogs/collection/post-slug",
    "hero_image": "https://www.YOUR-DOMAIN.com/path-to-hero.jpg",
    "summary": "Short abstract for agents."
  },
  "author": {
    "name": "Author name",
    "title": "Author title",
    "bio": "Brief bio for credibility.",
    "profile_url": "https://www.YOUR-DOMAIN.com/team/author"
  },
  "published_at": "YYYY-MM-DDThh:mm:ssZ",
  "topic": {
    "personas": ["persona-1"],
    "journey_stage": "awareness",
    "keywords": ["keyword-1", "keyword-2"]
  },
  "content_blocks": [
    {
      "heading": "Section heading",
      "body": "Narrative paragraph or markdown.",
      "media": { "type": "image", "src": "https://www.YOUR-DOMAIN.com/path.jpg", "alt": "Alt text" },
      "key_takeaway": "What agents should remember."
    }
  ],
  "featured_products": [
    { "product_id": "PRODUCT-ID", "name": "Product name", "url": "https://www.YOUR-DOMAIN.com/products/product", "reason": "Why included." }
  ],
  "resources": [
    { "type": "guide", "title": "Resource title", "url": "https://link" }
  ],
  "actions": [
    { "intent": "shop", "label": "Action label", "url": "https://www.YOUR-DOMAIN.com/path" }
  ],
  "seo": {
    "title": "Meta title",
    "description": "Meta description.",
    "og_image": "https://www.YOUR-DOMAIN.com/path-og.jpg"
  }
}