Cohort Retention

Renders a SaaS subscription or customer cohort retention triangular matrix with color-coded continuous gradients.

Surfaces
webmeet-stageapps-script-web
Fields
FieldType
cohortslist of dictionaries representing cohorts (e.g., [{'cohort_name': 'Jan 2026', 'original_size': 2500, 'retention_rates': [100.0, 93.4]}])required
periodslist of strings representing period headers (e.g., ['Month 0', 'Month 1'])required
color_scalelist of strings representing the continuous color scale (e.g., ['#1e293b', '#10b981'])required
titlestring (optional, chart title, e.g., 'SaaS Retention Cohorts')optional
Example payload
{
  "type": "cohort_retention",
  "cohorts": [
    {
      "label": "Jan 2025",
      "data": [
        100,
        72,
        58,
        45
      ]
    },
    {
      "label": "Feb 2025",
      "data": [
        80,
        65,
        50,
        38
      ]
    }
  ],
  "periods": [
    "Week 1",
    "Week 2",
    "Week 3",
    "Week 4"
  ],
  "color_scale": [
    "#3b82f6",
    "#10b981",
    "#f59e0b",
    "#ef4444"
  ]
}
ARD catalog entry
{
  "identifier": "urn:air:a2uicatalog.ai:atom:cohort_retention",
  "displayName": "Cohort Retention",
  "type": "application/vnd.a2ui.atom+json",
  "url": "https://a2uicatalog.ai/atoms/cohort_retention",
  "capabilities": [
    "web",
    "meet-stage",
    "apps-script-web"
  ],
  "description": "Renders a SaaS subscription or customer cohort retention triangular matrix with color-coded continuous gradients.",
  "representativeQueries": [
    "show a triangular cohort retention grid with continuous color-scale rendering",
    "renders a saas subscription or customer cohort retention triangular matrix with color-coded continuo",
    "render a cohort retention"
  ]
}
← Full ARD catalog Try it live →
Deploy your own renderer

The renderer is open source. Deploy your own instance in 4 commands — you own the URL, no dependency on the demo endpoint.

git clone https://github.com/a2uicatalog/a2ui
cd apps-script-surface/gas-schema-renderer
clasp push && clasp deploy
Full deploy guide →