Header Options
The header sits at the top of the card and contains the title, navigation arrows, view selector, add-event button, and the dark-mode toggle. You can hide any combination of these controls independently.boolean
default:"false"
Hide the entire card header, including the title and all controls. Useful when you want only the calendar grid itself to appear.
boolean
default:"false"
Remove the year from the date shown in the header. Helpful when space is tight and the year is implied.
Hide the previous and next navigation arrows so the card stays fixed on the current period.
boolean
default:"false"
Hide the view-selector dropdown (Month / Week / Schedule / Agenda) so the card stays locked to its
default_view.boolean
default:"false"
Hide the Add Event button from the header.
boolean
default:"false"
Hide the light/dark mode toggle button.
boolean
default:"false"
Hide all controls at once — equivalent to setting
hide_navigation_buttons, hide_view_selector, and hide_add_event_button to true simultaneously.boolean
default:"false"
Collapse the header into a single row by placing the title and controls side by side. This saves vertical space on smaller cards.
Show a button in the header that navigates to another Home Assistant dashboard. You must also set
header_dashboard_path for the button to appear.string
The path of the dashboard to open when the navigation button is clicked. For example,
/lovelace/calendar or /lovelace-custom/overview. Requires show_dashboard_nav_button: true.Calendar List Options
The calendar list lets users toggle individual calendars on or off from inside the card. These options control whether the list is shown and how each calendar is labelled.boolean
default:"false"
Hide the calendar visibility toggle list entirely.
boolean
default:"false"
Hide the text name next to each calendar’s colored dot in the calendar list, showing only the color indicators.
A list of calendar entity IDs that should be hidden when the card loads for the first time. The user can still reveal them using the calendar toggle list. Once the user changes their selection it is saved in browser storage and overrides this initial default for that browser.
map
A map of calendar entity IDs to initial visibility states. Use
show, shown, visible, on, or true to force a calendar visible; use hide, hidden, off, or false to hide it initially. This is an alternative to default_hidden_calendars when you prefer one map of explicit states.map
Legacy alias for
default_calendar_visibility. Use default_calendar_visibility for new configurations.map
Override the display name of any calendar in the card UI. The key is the entity ID and the value is the name you want shown.
map
Assign an MDI icon to a calendar. The icon appears as a badge next to the calendar’s colored dot in the calendar list and, optionally, on each event from that calendar.
list
A list of calendar entity IDs to exclude from the calendar badge row that appears in the card header. Calendars listed here will still appear in the main calendar grid and in the calendar toggle list — they are only hidden from the compact badge indicator strip at the top of the card.
Event Display Options
number
default:"11"
The font size (in pixels) of the event title text.
number
default:"9"
The font size (in pixels) of the event start/end time text.
number
default:"9"
The font size (in pixels) of the event location text.
boolean
default:"false"
Show the calendar’s friendly name beneath the event title in event detail modals.
string
default:"none"
Prepend a prefix to every event title in the calendar grid. Options:
none— no prefixbadge_icon— prepend the calendar’s MDI badge icon (requirescalendar_badge_icons)friendly_name— prepend the calendar’s display name
boolean
default:"false"
Hide the small colored dot (calendar indicator) that appears on each event chip in the grid.
list
A list of calendar entity IDs for which event start and end times should be hidden. Applies to Month, Week Compact, Schedule, and Agenda views. Useful for all-day or informational calendars where times add clutter.
boolean
default:"false"
Display times in a compact format — for example,
10 AM instead of 10:00 AM. Applies to Month, Week Compact, Schedule, and Agenda views.string
Override the browser or WebView timezone used by the card. Use an IANA timezone name, such as
America/New_York.Leave this unset to keep the existing behavior, which uses the device’s local timezone. If the value is blank or invalid, the card ignores it and falls back to the device timezone.boolean
default:"false"
Display full weekday names, such as
Monday and Tuesday, instead of abbreviated names like Mon and Tue. The card formats names using the configured locale or language, or the locale inherited from Home Assistant when neither is set.string
default:"inline"
Control how day badges are arranged in Week and Schedule day headers. Use
inline to keep the date and badges on one row, or stacked to place badges below the date. Invalid values fall back to inline.boolean
default:"false"
Show the event’s location text below the event title. Applies to Week Compact, Schedule, and Agenda views. Also applies to Month only when
show_all_details_month is enabled.boolean
default:"false"
When
show_event_location is also enabled, truncate long location strings to a shorter form so they don’t push event blocks taller. Applies to Week Compact, Schedule, and Agenda views. Also applies to Month only when show_all_details_month is enabled.string
default:"none"
Controls how events that have already ended are displayed:
none— past events appear exactly like future eventshide— past events are removed from view entirelymuted— past events are shown with reduced opacity to de-emphasise them
boolean
default:"false"
Legacy alias for
past_event_mode: hide. Use past_event_mode for new configurations because it also supports the muted option.boolean
default:"false"
Disable touch swipe gestures for navigating between weeks and months. Useful on dashboards where the card is embedded inside another scrollable container.