Support by Calendar Type
What you can do from inside the card depends on the underlying Home Assistant calendar integration. The card adapts its UI to each calendar’s capabilities — buttons for unsupported actions are hidden or disabled automatically.| Calendar type | Create | Edit | Delete |
|---|---|---|---|
| Local Calendar (Home Assistant built-in) | ✅ | ✅ | ✅ |
| Google Calendar | ✅ | ✅ * | ✅ |
| CalDAV | ✅ | * | * |
* Google Calendar edits use a safe create-then-delete flow. The Home Assistant Google Calendar integration does not expose a true update operation, so the card simulates editing by creating a new event with your changes and then deleting the original. From the user’s perspective the event appears edited; under the hood it is a brand new event.One side effect: the event’s UID changes, and any external links or integrations that reference the original UID will need to be updated.
CalDAV is version dependent. The card can always add new events to a CalDAV calendar, but editing and deleting existing events is dependent on the CalDAV version. Edit and delete functionality will be read by this card and it will show Edit/Delete buttons accordingly.
Creating Events
To create a new event, click the Add Event button in the card header. A modal form opens where you fill in:- Event title (required)
- Start date and time
- End date and time
- All-day toggle — when enabled, time fields are hidden and the event spans the full day
- Location — optional venue or address
- Description — optional free-text notes (supports Markdown and basic HTML)
- Calendar — choose which calendar the event is saved to from a dropdown of your writable calendars
Editing Events
To edit an existing event, click it anywhere in the calendar grid to open the event detail modal. Then click Edit Event. The same form used for creation appears, pre-populated with the event’s current data. Make your changes, then click Save Changes. The Edit button only appears for events on calendars that support editing. See Support by Calendar Type above for the per-integration matrix.Recurring Events
When creating or editing an event, toggle the Recurring switch to reveal recurrence options:- Frequency —
Daily,Weekly,Monthly, orYearly - Interval — repeat every N frequency units (e.g. every 2 weeks)
- Weekdays — for weekly recurrence, select which days of the week the event falls on
- End condition — choose
Never,On a date(enter an end date), orAfter N occurrences
Deleting Events
From the event detail modal, click Delete. You will be asked to confirm. For recurring events, a second prompt asks you how to apply the deletion:| Option | Effect |
|---|---|
| This event only | Removes only the single occurrence you clicked |
| This and future events | Removes this occurrence and every one after it |
| All events | Removes the entire recurring series |
Configuration Options
Master switch for all event management features. Set to
false to make the card completely read-only — the Add Event button is hidden and clicking events opens a read-only detail view with no Edit or Delete actions.A list of calendar entity IDs that should be treated as read-only even when event management is enabled. Events on these calendars can be viewed but not edited or deleted from the card.
Hide the Add Event button from the header. Users can still edit and delete existing events unless you also disable event management or mark calendars as read-only.
