Skip to main content
If your Home Assistant setup has many calendar entities — for example, a separate calendar for each family member, or different calendars per project — the card header’s toggle list can quickly become cluttered. Virtual calendars solve this by letting you group multiple real calendar entities under a single named entry. When a user toggles the virtual calendar on or off in the header, all of its member calendars are shown or hidden together. Events from all grouped entities are aggregated and displayed with the virtual calendar’s shared color and icon, giving your view a clean, organized appearance.

​
Configuration

Virtual calendars are defined as a list under the virtual_calendars key. Each entry represents one group.
​
string
required
A unique internal identifier for this virtual calendar. This ID is used when referencing the virtual calendar in event_styles or day_styles match rules. It must be unique across all virtual calendar definitions.
​
string
The display name shown in the card header’s calendar toggle list.
​
string[]
A list of real Home Assistant calendar entity IDs to include in this group. Events from all listed entities are combined and treated as belonging to this virtual calendar.
​
string
A hex color string applied to all events from this virtual calendar. Individual event colors from the source entities are replaced by this shared color.
​
string
An MDI icon name (e.g. mdi:account-group) displayed next to the virtual calendar’s name in the header toggle.
Each id must be unique. If two virtual calendar entries share the same id, the card will raise a validation error and may not render correctly. Choose IDs that are descriptive and won’t conflict, such as family, work, or sports_league.

​
How Virtual Calendars Appear in the Card

Virtual calendars replace their member entities in the card header’s toggle list — you see the virtual calendar’s name and icon instead of the individual entity IDs. Toggling the virtual calendar on or off controls all of its member entities at once. Event chips on the calendar display the virtual calendar’s color rather than the original entity color, and any event_styles or day_styles rules that reference the virtual calendar’s id will match events from all its member entities.

​
Using Virtual Calendars with Event Styles

You can target a virtual calendar in event_styles match rules by using its id as you would a normal entity ID in the calendar match field.

​
Visual Editor Support

You can create and manage virtual calendars directly in the card’s visual configuration editor without writing YAML. The editor provides fields for name, entity selection, color, and icon for each group.

​
Example

This configuration creates two virtual calendars: one for family members and one for work-related calendars.
With this configuration, the card header shows two toggles — Family and Work — instead of five separate calendar entity entries. Toggling “Family” off hides events from all three family calendars simultaneously.
Pair virtual calendars with combine_calendars: true if family members or colleagues share events across their individual calendars. Combined with virtual calendars, duplicate events will be merged and shown once using the primary matching calendar color. If the duplicate sources are inside the same virtual group, that is the virtual calendar color.