Metrics pillar · v0.15.1
cohort Cohort
Retention cohort — a group of users acquired in a specific period, tracked through their lifecycle. Each row in `retention` records how many of the original cohort were still active at a given period offset (month 0, 1, 2, …) and the implied retention rate. Used to build retention curves and derive metrics like net dollar retention. Scope: many per company, one file per cohort. Lives at `metrics/cohorts/<slug>.yaml`.
$id · https://corpospec.com/schemas/v0.15.1/cohort.schema.json
Fields
| Field | Type | Required | Description |
|---|---|---|---|
| id | PathRef | yes | Path-based cross-reference relative to .corpospec/ root. Pattern: `^[a-z0-9_-]+(/[a-z0-9_.-]+)+$` |
| name | string | yes | |
| period | IsoDate | yes | ISO 8601 date (YYYY-MM-DD). |
| retention | CohortPeriod[] | yes | |
| size | integer | yes |
Definitions
Shared types referenced within this schema.
CohortPeriod
Retention data for a single period within a cohort.
type: object
IsoDate
ISO 8601 date (YYYY-MM-DD).
type: string
PathRef
Path-based cross-reference relative to .corpospec/ root.
Pattern: `^[a-z0-9_-]+(/[a-z0-9_.-]+)+$`
pattern: ^[a-z0-9_-]+(/[a-z0-9_.-]+)+$
Reference in your YAML
# yaml-language-server: $schema=https://corpospec.com/schemas/v0.15.1/cohort.schema.json