2026.10.0
Home ▸ Dashboards

Calendar card

The calendar card displays your calendarA calendar entity represents a schedule of events coming from a local or external calendar source. It can be used to trigger automations based on the start or end of an event, react to offsets (like 15 minutes before), or retrieve event details through services. [Learn more] entitiesAn entity represents a sensor, actor, or function in Home Assistant. Entities are used to monitor physical properties or to control other entities. An entity is usually part of a device or a service. [Learn more] in a month, day, and list view (7 days).

Screenshot of the calendar card Screenshot of the calendar card.

All options for this card can be configured via the user interface.

Adding the calendar card to a dashboard

  1. In the top right of the screen, select the edit button.
    • If this is your first time editing a dashboard, the Edit dashboard dialog appears.
      • By editing the dashboard, you are taking over control of this dashboard.
      • This means that it is no longer automatically updated when new dashboard elements become available.
      • Once you’ve taken control, you can’t get this specific dashboard back to update automatically. However, you can create a new default dashboard.
      • To continue, in the dialog, select the three dots menu, then select Take control.
  2. Add a card and customize actions and features to your dashboard.

YAML configuration

The following YAML options are available when you use YAML mode or just prefer to use YAML in the code editor in the UI.

Configuration Variables

Looking for your configuration file?
type string Required

calendar

title string (Optional)

The title of the card.

initial_view string (Optional)

The view that will show first when the card is loaded onto the page. Options are dayGridMonth, dayGridDay, and listWeek. Note that listWeek does show the next 7 days, not a calendar week.

entities list Required

A list of calendar entities that will be displayed in the card.

theme string (Optional)

Override the used theme for this card with any loaded theme. For more information about themes, see the frontend documentation.

show_add_event boolean (Optional, default: false)

Show a button to create a new event. You need at least one calendar that allows you to create events.

add_event_style string (Optional, default: below)

The layout and position of the add event button within the card. Options are header, below, and on_top.

add_event_size string (Optional, default: small)

The size of the add event button. Options are small, medium, and large. Note that the size is ignored when the style is set to header.

Examples 

type: calendar
entities:
  - calendar.calendar_1
  - calendar.calendar_2

Related topics