{
  "version": "1.3.0",
  "releasedAt": "2026-05-20",
  "kpi": {
    "rogueId": "customers.customer_segments",
    "slug": "customer_segments",
    "domain": "customers",
    "defaultLabel": "Customer Segments",
    "description": "Container handle for the field-array of customer segments — each entry carries a segment name, its customer count, and its ARR. Feeds the bespoke customers card's segmentation stack-bars (customer-count + revenue distribution across segments). The \"where does the revenue / logo base concentrate\" surface (e.g. Enterprise / Mid-Market / SMB). Common pitfall: segment definitions drifting over time, or segment ARR not summing to total ARR because a segment is missing — keep the segmentation exhaustive and the cut stable.",
    "fieldType": "text",
    "unit": null,
    "maturity": "general",
    "suggestedForStages": [
      "seriesA",
      "seriesB",
      "seriesC",
      "public"
    ],
    "defaultOwningFunctions": [
      "Sales"
    ],
    "stageRelevance": {
      "seriesA": "recommended",
      "seriesB": "recommended",
      "seriesC": "recommended",
      "public": "recommended"
    },
    "definitionSource": {
      "tier": "editorial",
      "sourceName": "imboard Editorial",
      "sourceUrl": null,
      "sectionRef": null,
      "publicationDate": "2026-04-01",
      "attributionNotice": null
    },
    "formula": "Container — field-array of { name, customerCount, segmentARR } rows. No aggregate calculation; the surface's purpose is to show the distribution. Segment counts should sum to total customers and segment ARR to total ARR.",
    "whyItMatters": "Shows where the book concentrates by logo and by revenue — a base that is logo-heavy in SMB but revenue-heavy in Enterprise has a very different risk profile than its headline ARR suggests.",
    "interpretationGuidance": "Compare the logo distribution to the ARR distribution: a small Enterprise logo share carrying most of the ARR is a concentration flag worth reading with `customers.top_customer_concentration`.",
    "relatedKpiIds": [
      "customers.total_customers",
      "customers.top_customer_concentration",
      "sales.arr"
    ]
  }
}