Home Assistant

Calendar card

The calendar card displays your calendar entities in a month, day and list view (7 days).

Screenshot of the calendar card Screenshot of the calendar card.

To add the calendar card to your user interface:

  1. In the top right of the screen, select the three dots menu and then select Edit dashboard.
    • 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. To continue, in the dialog, select Take control.
  2. In the bottom right corner, select the Add card button and select from the card picker.

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

Card settings

Title

The title displayed at the top of the card.

Initial View

The view that will show first when the card is loaded onto the page. Options are Month View, Day View, or List (7 days).

Entities

The calendar entities that will be displayed in the card.

Theme

Name of any loaded theme to be used for this card. For more information about themes, see the frontend documentation.

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.

Examples

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