Cohort Retention Grid
A retention heatmap with weekly signup cohorts as rows, weeks since signup as columns, shaded cells, a shade legend, and a methodology note.
A retention heatmap with weekly signup cohorts as rows, weeks since signup as columns, shaded cells, a shade legend, and a methodology note.
Search blocks by description or jump to a page.
The source for every Application block is included with Basic and Pro. Pick a plan to copy the code.
Already purchased? Log in
Cohort Retention Grid lays out eight weekly signup cohorts as rows, from Apr 20 at 412 users down to the freshest Jun 8 cohort at 418, with weeks since signup as columns from Week 0 through Week 7. Each cell is shaded by the share of the cohort still active that week, so a strong week reads dark and a thin one reads faint. Newer cohorts trail off into a staircase of muted pending cells, and two dropdown chips (Weekly cohorts, Active users) sit above the grid.
Cohorts are one typed array and cellClass maps each value to a foreground opacity band, so the heatmap needs no chart library. A shade legend runs across the footer next to the methodology note that a user counts as active with one or more sessions in the week, which is the definition every retention debate eventually turns on.
Reach for this block on a retention or growth dashboard, wired to your cohort query and active-user definition. The two dropdown chips should switch the cohort grain and the retention event without leaving the page.
A natural flow around it on an Application Pro page:
Before
After
One strong use is signup cohort retention. Other grids of the same shape:
Tip: the active definition in the footer note settles more arguments than any single cell, so keep it visible.