Skip to main content

Calendar View

The calendar view is the main interface for viewing and interacting with your events. It supports multiple view modes, a customizable toolbar, and a range of visual options.

View Modes​

Prisma Calendar offers four view modes, switchable from the toolbar:

ViewDescription
Month (dayGridMonth)Full month grid with event chips. Color dots indicate events on each day.
Week (timeGridWeek)Seven-day time grid with hourly slots. Events display at their exact times.
Day (timeGridDay)Single-day time grid for detailed scheduling.
List (listWeek)Flat list of events for the current week, sorted chronologically.

Configure the default view in Settings → Calendar → View Configuration → Default view.

Mobile View​

Mobile devices (screen width ≤ 768px) can use a different default view, optimized for smaller screens. Configure in Settings → Calendar → View Configuration → Default mobile view.

Toolbar​

The toolbar sits at the top of the calendar and provides quick access to navigation, event creation, filtering, and display controls. Each button can be individually shown or hidden in Settings → Configuration → Toolbar Buttons.

ButtonAction
Left (◀)Navigate to the previous period (previous month, week, or day depending on current view)
Right (▶)Navigate to the next period
TodayJump to today's date
NowScroll to the current time in day and week views. Not available in month or list views.

Event Creation​

ButtonAction
Create EventOpens the Create Event modal. You can also create events by clicking or dragging on empty calendar space.

Zoom Level​

ButtonAction
Zoom LevelDisplays the current time slot duration (e.g., "10m"). Click to cycle through zoom levels, or use CTRL+scroll to zoom in and out.

Zoom controls the granularity of time slots in day and week views. The default zoom levels are 1, 2, 3, 5, 10, 15, 20, 30, 45, 60 minutes, configurable in Settings → Calendar → Time Display → Zoom levels. The viewport stays centered on the same time when zooming.

Filtering​

ButtonAction
Search InputText field for filtering events by title. Case-insensitive. Press Enter or blur to apply.
Expression FilterText field for property-based filtering using JavaScript expressions (e.g., Status !== 'Done').
Filter Presets (▼)Dropdown to apply saved filter expressions with one click. Select "Clear" to remove the active filter.

See Filtering for full documentation on search, expressions, and presets.

Other Toolbar Buttons​

ButtonAction
Untracked EventsOpens a dropdown showing events without date properties. See Untracked Events.
TimelineOpens the timeline visualization showing all events in a horizontal layout.
note

Reopen the calendar view for toolbar changes to take effect.

Time Display​

Configure the visible time range and slot behavior in Settings → Calendar → Time Display:

  • Day start / end hour: Visible time range in day and week grids (default: 7:00–22:00)
  • Slot duration (minutes): Height of each grid slot (default: 10 minutes, range: 1–60)
  • Snap duration (minutes): Drag and resize snapping interval (default: 10 minutes, range: 1–60)
  • Zoom levels (minutes): Comma-separated list for CTRL+scroll zoom (default: 1, 2, 3, 5, 10, 15, 20, 30, 45, 60)

Visual Appearance​

Display Density​

Two density modes control event spacing:

  • Comfortable (default): Standard spacing between events
  • Compact: Reduced spacing for more events on screen

Configure in Settings → Calendar → Visual Appearance → Display density.

Event Text Coloring​

The calendar automatically adjusts event text color based on the event's background color for readability:

  • Default event text color: Used on events with dark backgrounds (default: white)
  • Alternative event text color: Used on events with light or white backgrounds (default: black)

The detection is automatic — the calendar evaluates the background luminance and picks the appropriate text color.

Configure both in Settings → Calendar → Visual Appearance.

Other Visual Options​

  • All-day event height: Maximum pixel height for all-day events before they scroll internally (30–500px, default: 75px)
  • Past event contrast: Dims past events (0% = invisible, 100% = normal, default: 70%)
  • Show color dots: Color indicator dots in monthly view cells (enabled by default)
  • Thicker hour lines: Bolder full-hour dividers in day/week views (enabled by default)
  • Show duration in event title: Appends duration in parentheses after the title for timed events, e.g., "Meeting (2h 30m)" (enabled by default)
  • Show decimal hours: Displays durations as decimal hours (e.g., 2.5h) instead of formatted (e.g., 2h 30m)

Sticky Headers​

Sticky headers keep context visible while scrolling in day and week views:

  • Sticky day headers: Pins the day/date column headers at the top of the viewport
  • Sticky all-day events: Pins the all-day event section below the day headers (or at the top if day headers are not sticky)

When both are enabled, the all-day section sticks directly below the day headers with no gap.

These options only affect day and week views where vertical scrolling occurs. Month and list views are not affected.

Configure in Settings → Calendar → Visual Appearance.

Event Interaction​

  • Enable event preview: Hover previews inside the calendar (enabled by default)
  • Event hover tooltips: Displays event name with time/duration, file path, frontmatter properties, and the first three lines of note content
  • Show current time indicator: Red time line in day/week views (enabled by default)
  • Highlight upcoming event: Highlights the next upcoming event (enabled by default)
  • Skip underscore properties: Hides properties starting with _ from event chips (enabled by default)

Configure in Settings → Calendar → Event Interaction.

Event Overlap​

Control how events display when they share the same time:

  • Allow event overlap: Whether events can visually overlap in all views (default: enabled)
  • Allow slot event overlap: Whether events can overlap within the same time slot in time grid views (default: enabled)
  • Event stack limit: Maximum events to stack before showing "+more" link (1–10, default: 1)
  • Desktop max events per day: Maximum events per day on desktop before "+more" (0–10, 0 = unlimited, default: 0)
  • Mobile max events per day: Maximum events per day on mobile before "+more" (0–10, default: 4)

Configure in Settings → Calendar → Event Overlap.

Hide Weekends​

Toggle Saturday and Sunday visibility in Settings → Calendar → View Configuration → Hide weekends.

First Day of Week​

Set which day starts the week (0 = Sunday, 1 = Monday, etc.) in Settings → Calendar → View Configuration → First day of week.

See Also​