Activating Month View
Setdefault_view to month in your card configuration to open the card on the monthly grid by default:
hide_view_selector: true.
Configuration Options
boolean
default:"false"
Used by Month only.By default, day cells truncate their event list and show a +N more overflow label when there are more events than fit in the cell. Set this to
true to expand every day cell and display all events without truncation. This increases the row height dynamically, so the card will grow taller on busy weeks.boolean
default:"false"
Used by Month only.When
true, each event chip in the month grid includes the event start time and any additional detail text alongside the event title. This is also the flag that enables show_event_location / use_short_location rendering in Month — otherwise location is omitted from Month event chips.boolean
default:"false"
Used by Month only.Adds an ISO week-number column on the left edge of the grid (e.g., W 23). Handy for work or project planning where teams reference week numbers.
string
default:"create"
Used by Month only. Controls what happens when you tap an empty part of a day cell (tapping an event chip always opens that event’s detail). Accepted values:
create(default) — preserves the existing behavior:- if event management is enabled and there is at least one writable calendar → open the new-event form prefilled with that date;
- otherwise, if the day has visible events → open the day-events popup (see below);
- otherwise (a day with no visible events and no way to create one) → nothing happens.
show_events— tapping a day that has visible events opens a popup listing that day’s visible events (i.e. after hidden-calendar, hidden-style, andpast_event_modefiltering); tap any event there to view, edit, or delete it. Empty days still open the new-event form (when event management is enabled and a writable calendar exists), so blank days stay quick to add to.
show_events popup, an Add Event button (prefilled with that date) is shown when all of the following are true: event management is enabled, at least one writable calendar exists, and hide_add_event_button is false.Within the popup, closing an event’s details — or adding, editing, or deleting an event — returns you to the day-events list (refreshed), rather than dropping back to the calendar.This is handy on phones, where a busy day’s chips can be hard to read in the grid.number
default:"null"
Used by Month only.By default, Month view snaps to a full calendar month — every cell from the 1st to the last day of the current month, padded with neighboring days to fill complete weeks. Set
rolling_weeks to a positive integer to switch to a rolling N-week window that always starts on the current week and looks forward N weeks.For example, rolling_weeks: 4 renders four week rows: this week plus the next three. Navigation arrows shift the window one week at a time instead of one month.number
default:"0"
Used by Month, Week Compact, and Schedule. In Week Compact and Schedule, only affects normal week mode — it is ignored in rolling-days mode.The day number (0–6) that anchors the left edge of the grid. Set to
1 to start each row on Monday.boolean
default:"false"
Used by Month, Week, Schedule, and Agenda.When
true, event time labels are abbreviated — for example 10 AM instead of 10:00 AM. In Month, time labels only appear on event chips when show_all_details_month is enabled.boolean
default:"false"
Used by Month, Week, Schedule, and Agenda. Despite the name, it is used by the shared event-time formatter, not only the Schedule view.When
true, event times use 24-hour format (e.g. 14:00) instead of 12-hour format with AM/PM.boolean
default:"false"
Used by Week, Schedule, and Agenda. Also applies to Month only when
show_all_details_month is enabled — it does not affect normal Month event chips.When true, the location field of each event is displayed below the event title.boolean
default:"false"
Used by Week, Schedule, and Agenda. Also applies to Month only when
show_all_details_month is enabled. Has no visible effect unless show_event_location is also enabled.Truncates long location strings to a shorter form so they don’t push event chips taller.array
default:"[]"
Used by Month, Week, Schedule, and Agenda.An array of calendar entity IDs whose events should not display time labels. Useful for all-day-style calendars where exact times are noise.
string
default:"none"
Used by Month, Week, Schedule, and Agenda. Controls how events that have already ended are handled across the card. Accepted values:
none— past events look identical to upcoming events (default).muted— past events are rendered at reduced opacity so today’s and future events stand out.hide— past events are not rendered at all.
