Ecommerce — Static Pages

Express policies, FAQs, and operational guarantees in machine-readable form so agents can cite them verbatim.

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

Fields

Map long-form policy and support information into consistent evidence blocks.

Field	Description
`template`	String identifier; always `ecommerce_static_page`. Required.
`version`	Semantic version number. Required.
`updated_at`	ISO 8601 timestamp for the JSON snapshot. Required.
`page`	Core metadata (`slug`, `title`, `url`, `category`, `summary`).
`owners`	Team or role responsible for the policy, including escalation contacts.
`sections`	Ordered array of objects with `heading`, `body`, optional `list`, and `effective_date`.
`questions`	FAQ style entries with `question`, `answer`, and optional `related_actions`.
`metrics`	Operational metrics such as turnaround time, satisfaction scores, or compliance targets.
`contact`	Dedicated support paths for this policy: `email`, `phone`, `chat_url`, `hours`.
`actions`	Steps the customer or agent should take (submit request, print label, schedule repair) with `type` and `url`.
`related_documents`	Links to PDF policies, legal language, or partner programs.

Example schema — handsomecalavera.com

{
  "template": "ecommerce_static_page",
  "version": "1.0.0",
  "updated_at": "2024-01-30T16:22:00Z",
  "page": {
    "slug": "returns-and-repairs",
    "title": "Returns & Repairs",
    "url": "https://www.handsomecalavera.com/pages/returns-and-repairs",
    "category": "policy",
    "summary": "Lifetime repair coverage and a 45-day return window on all handcrafted goods."
  },
  "owners": [
    { "team": "Customer Care", "email": "[email protected]" },
    { "team": "Repair Studio", "email": "[email protected]" }
  ],
  "sections": [
    {
      "heading": "Return eligibility",
      "body": "Unused goods can be returned within 45 days of delivery with original packaging and proof of purchase.",
      "effective_date": "2023-11-01"
    },
    {
      "heading": "Repair coverage",
      "body": "We repair stitching, hardware, and finish issues caused by normal use for the lifetime of the product.",
      "list": [
        "Complimentary repairs on stitching and rivets",
        "Hardware replacement billed at cost after first year",
        "Finish refresh available annually"
      ],
      "effective_date": "2024-01-01"
    }
  ],
  "questions": [
    {
      "question": "How do I start a return?",
      "answer": "Submit your order number and reason via the Returns Portal. We'll email a prepaid label within one business day.",
      "related_actions": [
        {
          "type": "portal",
          "label": "Open returns portal",
          "url": "https://www.handsomecalavera.com/apps/returns",
          "availability": "online"
        }
      ]
    },
    {
      "question": "How long do repairs take?",
      "answer": "Repairs are inspected within 48 hours and typically completed within 10 business days.",
      "related_actions": [
        {
          "type": "schedule",
          "label": "Book repair intake call",
          "url": "https://cal.com/handsomecalavera/repair-intake",
          "availability": "appointment"
        }
      ]
    }
  ],
  "metrics": [
    { "name": "Average repair turnaround", "value": "8.6 business days (Q4 2023)" },
    { "name": "Return approval rate", "value": "97%" }
  ],
  "contact": {
    "email": "[email protected]",
    "phone": "+1-512-555-0118",
    "chat_url": "https://www.handsomecalavera.com/pages/contact#chat",
    "hours": "Mon–Fri 9am–6pm CT"
  },
  "actions": [
    {
      "type": "start_return",
      "label": "Begin a return",
      "url": "https://www.handsomecalavera.com/apps/returns",
      "availability": "online"
    },
    {
      "type": "repair_request",
      "label": "Request a repair",
      "url": "https://www.handsomecalavera.com/pages/repair-request",
      "availability": "online"
    }
  ],
  "related_documents": [
    {
      "title": "Repair program overview (PDF)",
      "url": "https://www.handsomecalavera.com/assets/downloads/repair-program.pdf"
    },
    {
      "title": "Warranty terms",
      "url": "https://www.handsomecalavera.com/pages/warranty"
    }
  ]
}

Copy & paste template

{
  "template": "ecommerce_static_page",
  "version": "1.0.0",
  "updated_at": "YYYY-MM-DDThh:mm:ssZ",
  "page": {
    "slug": "page-slug",
    "title": "Page title",
    "url": "https://www.YOUR-DOMAIN.com/pages/page-slug",
    "category": "policy",
    "summary": "What this page covers."
  },
  "owners": [
    { "team": "Team name", "email": "[email protected]" }
  ],
  "sections": [
    {
      "heading": "Section heading",
      "body": "Key policy language or explanation.",
      "list": ["Optional bullet"],
      "effective_date": "YYYY-MM-DD"
    }
  ],
  "questions": [
    {
      "question": "FAQ question",
      "answer": "Answer in clear, concise language.",
      "related_actions": [
        { "type": "portal", "label": "Call-to-action", "url": "https://www.YOUR-DOMAIN.com/path" }
      ]
    }
  ],
  "metrics": [
    { "name": "Metric name", "value": "Value" }
  ],
  "contact": {
    "email": "[email protected]",
    "phone": "+1-000-000-0000",
    "chat_url": "https://www.YOUR-DOMAIN.com/support/chat",
    "hours": "Support hours"
  },
  "actions": [
    { "type": "action_type", "label": "Action label", "url": "https://www.YOUR-DOMAIN.com/path", "availability": "online" }
  ],
  "related_documents": [
    { "title": "Document title", "url": "https://www.YOUR-DOMAIN.com/doc.pdf" }
  ]
}