# Chart Cohort Retention

Weekly retention of product sign-up cohorts over the first twelve weeks.

- id: `chart-cohort-retention`
- Page: https://agentic-ui-kit.com/components/chart-cohort-retention
- Live preview: https://agentic-ui-kit.com/live/component/chart-cohort-retention

## Install

```bash
agentic-ui add chart-cohort-retention
npx shadcn@4.17.0 add @agentic-ui/chart-cohort-retention
```

## Metadata

- **Level:** block
- **Category:** block
- **Installable in:** Radix UI (registry variant new-york), Base UI (registry variant base-vega)
- **Capabilities:** cohort-grid, triangular-matrix, intensity-scale, weekly-monthly-granularity, metric-switching, weighted-period-average, half-life-detection, cell-inspector, keyboard-grid-navigation, intensity-highlight, empty-states
- **Intents:** compare-over-time, track-status, explore-detail
- **Suits domains:** analytics, saas, billing, ecommerce, operations
- **Interaction:** granularity-toggle, metric-toggle, intensity-highlight, cell-selection, keyboard-grid-navigation
- **Screen role:** overview
- **Density:** compact
- **Dark mode:** yes
- **Use it for:** Weekly retention of product sign-up cohorts over the first twelve weeks, Monthly subscriber survival by subscription month and half-life detection, Buyer retention by acquisition campaign in e-commerce
- **Avoid when:** A single time series without grouping by entry cohort (use chart-sparkline or a time series), Intensity matrix without relative survival semantics, such as activity by hour and day (use chart-heatmap-matrix)
- **Preserve when adapting:** triangular-cohort-geometry, relative-period-semantics, intensity-scale-steps, keyboard-contract
- **Replace when adapting:** cohort-labels-and-locale, metric-copy, period-granularity-naming
- **Adaptation effort:** low
- **Coupling:** low
- **Quality score:** 9.2/10
- **Quality breakdown:** visual 9/10, responsive 9/10, accessibility 9/10, code 9/10
- **Uses primitives:** card, button, badge, skeleton
- **npm dependencies:** lucide-react
- **Motion:** profile subtle, library css, reduced-motion fallback yes
- **Used in:** Analytics (blueprint), Marketing Analytics (blueprint)
- **npm dependencies (registry):** lucide-react@0.577.0
- **Registry dependencies:** lib-primitives