Heatmap (Pro)
The Heatmap tab requires Prisma Calendar Pro.
A GitHub-style contribution heatmap showing event density over time. See patterns, streaks, and activity density at a glance — then click any day to drill into its events.
Toolbar
The toolbar above the heatmap contains filtering controls on the left and view mode toggles on the right.
Filtering and Search
The heatmap toolbar includes the same filter bar available in all views — filter preset dropdown, expression filter, and search bar. Filtering is applied in real time as you type. See Rules & Filters for details on filtering syntax and presets.
View Mode Toggles
Toggle between Yearly and Monthly using the buttons on the right side of the toolbar. Your mode selection is preserved as you navigate.
View Modes
- Yearly: Shows all 365 days of a year in a compact grid. Day labels (Mon, Wed, Fri) appear on the left, month labels (Jan, Feb, ...) appear along the top.
- Monthly: Shows one month at a time with larger cells and day numbers (1–31) inside each cell. Full day-of-week headers are displayed.
Navigation
- ← / → buttons: Move backward/forward by one year (yearly mode) or one month (monthly mode).
- Now button: Jump to the current year or month.
- Keyboard (no cell selected): Press Left/Right arrow keys to move between time periods — works immediately when the tab is active.
- Keyboard (cell selected): Click any cell to select it, then use Arrow keys to move between cells. Navigation wraps: moving down past the last row continues at the top of the next column, and vice versa. Click the same cell again to deselect and return to interval navigation.
- Header label: Shows the current year (yearly) or "Month Year" (monthly) so you always know where you are.
Color Intensity
The heatmap uses a 5-level color gradient based on event count quartiles:
| Level | Meaning |
|---|---|
| Empty | No events — neutral border color |
| 1 | Low activity (up to 25th percentile) |
| 2 | Below average (25th–50th percentile) |
| 3 | Above average (50th–75th percentile) |
| 4 | High activity (above 75th percentile) |
When a category color is set, the gradient is tinted with that color at varying opacities. Without a category color, it uses the classic green gradient.
A legend at the bottom shows the color scale from "Less" to "More".
Day Detail Panel
Click any day cell to open the detail panel below the heatmap. It shows:
- Date header: The selected date and total event count.
- Event list: Every event for that day, each row showing:
- Time: Displayed as "2:30 PM" for timed events, or "All day" for all-day events.
- Title: The event name.
- Color tint: Each row is tinted with the event's resolved color so you can visually identify categories.
- Frontmatter properties: If configured via the
Display properties (heatmap)setting, additional properties appear below the title (e.g., status, priority, project).
- Click an event to open its file in the editor.
- Ctrl/Cmd + hover to see a backlink preview.
Live Updates
The heatmap updates automatically when events or settings change — new events, edits, color rule changes, and display property changes are reflected immediately without switching tabs.
Week Layout
The first day of the week follows your calendar's First day of week setting (Settings → General). If set to Monday, Monday appears in the leftmost column; if Sunday, Sunday does.
Events Modal Heatmap
The heatmap is also available inside the events modal, giving you a quick density overview without leaving the event view.
Command
Use Show all events heatmap (Prisma Calendar: Show all events heatmap) to switch directly to the Heatmap tab from anywhere.
The Heatmap is also available as a toolbar button (not enabled by default — add it via Settings → Toolbar).