github alexpfau/calendar-card-pro v6.0.0-beta.2

pre-release43 minutes ago

Calendar Card Pro v6.0.0-beta.2

The second beta of v6.0. It adds one height for the whole card in every layout and a filter for the hours a calendar's events start in, keeps a layout's headers in place while its events scroll, folds the view switcher into one button on a narrow card, makes the Month editor name its two forms the same way everywhere, loads the visual editor in your language only, and fixes what a full review of beta 1 found. It is offered only to people who ask for it. If you did not, Home Assistant keeps you on v5.3.0.

Beta 1 brought the Month layout, the rebuilt visual editor and private calendars. Its release notes describe them, and they still apply.

Warning

Back up your dashboard YAML before you install the beta (edit the dashboard, then ⋮ → Raw configuration editor, and copy everything). Going back to v5.3.0 is possible, but a card the v6 editor has saved needs a hand edit to look as it did. See Going Back to Stable.

⚠️ Going Back to Stable

v5.3.0 can read a card saved by the beta, and it never breaks on one, but five things do not come back by themselves.

1. Private calendars are shown in full. v5.3.0 has no private mode and ignores private: true, so every title, location and description of a private calendar shows again on your dashboard. Before you go back, remove those calendars from the card, or remove the card.

2. Weather disappears. When the v6 editor opens a card with weather and you save it, the weather moves from one top-level weather: block into weather_entity and a weather: block per layout. v5.3.0 reads neither, so the card shows no weather. To restore it, put the top-level block back. A card the beta saved looks like this:

weather_entity: weather.home
list:
  weather:
    position: date
    date:
      show_conditions: true
      show_high_temp: true
column:
  weather:
    position: date
    date:
      show_conditions: true
      show_high_temp: true

v5.3.0 needs this, with the options copied from the layout you use most:

weather:
  entity: weather.home
  position: date
  date:
    show_conditions: true
    show_high_temp: true

The leftover weather_entity and layout weather: lines only cause a console warning in v5.3.0, and the beta reads its own block again if you come back.

3. The card loses its height. v5.3.0 ignores card_height and card_max_height, so the card grows with its events again. When the beta's editor sets Card Height to Fixed or Maximum, it also clears that layout's height and max_height, so nothing is left for v5.3.0 to read. To keep a height, add height or max_height back. In v5.3.0 they size the events area under the header, so set them smaller than the whole card by the height of its title and toolbar. If v5.3.0's editor saves the card, it removes a top-level card_height and card_max_height; the same lines inside a layout's block stay.

4. Start hours are ignored. v5.3.0 has no starts_after or starts_before, so a calendar narrowed by them shows all its events again, and a calendar listed twice to divide its events by hour shows every event in both blocks.

5. v5.3.0's visual editor will not open the card. The beta's editor saves config_version: 6, and v5.3.0's editor shows This Card Uses a Newer Configuration for it. Set config_version: 5 in YAML to edit the card in v5.3.0's editor; the card itself keeps working either way.

A card set to view: month opens as a list in v5.3.0. Everything else you set in the beta stays in the YAML, unused, and v5.3.0's editor keeps it when it saves, apart from the top-level heights in point 3. The editor's language files (editor-de.js and the others) stay in the card's folder; v5.3.0 never loads them, and they do no harm.

To go back, on Home Assistant 2026.11 or later: Settings → Marketplace → Calendar Card Pro → ⋮ → Install another version → v5.3.0, then reload the browser. If you chose Include pre-releases, choose Exclude pre-releases in the same menu too. Excluding them alone does not go back: an installed beta stays until a newer stable version is out.

With the HACS integration on an older Home Assistant: HACS → Calendar Card Pro → ⋮ → Redownload → Need a different version? → v5.3.0, and turn off the card's Pre-release switch if you turned it on.

🧪 Installing the Beta

If you are on beta 1 and chose Include pre-releases, or turned on the Pre-release switch, beta 2 is offered as an ordinary update.

Otherwise, on Home Assistant 2026.11 or later, open Settings → Marketplace → Calendar Card Pro, then its ⋮ menu:

  • Install another version → v6.0.0-beta.2 (marked Pre-release) installs this beta once.
  • Include pre-releases offers this beta, every later one and v6.0.0 when it ships as ordinary updates.

Reload the browser afterward.

With the HACS integration on an older Home Assistant: HACS → Calendar Card Pro → ⋮ → Redownload → Need a different version? → v6.0.0-beta.2. To be offered every beta, enable and turn on the card's Pre-release switch (Settings → Devices & services → HACS → Calendar Card Pro).

This release has 13 files: the card, the editor, and one file for each of the eleven translated editor languages. The Marketplace and HACS download all of them. If you install by hand, copy the file for your language too, as Manual Installation describes; without it the editor opens in English.

The browser console banner should read Calendar Card Pro v6.0.0-beta.2. If it does not, clear the browser cache.

🎉 New Since Beta 1

📏 One Height for the Whole Card

card_height and card_max_height now size the whole card, its title, toolbar and notices included, in every layout. Set them once at the top level and a card that switches layouts keeps one height; set them in list:, column:, time_grid: or month: for a height per layout.

card_height: 600px

List scrolls within the height, Columns leave room under their days, Grid fits its hours to it and Month shares it among its weeks. height and max_height keep their v5 meaning, the events area under the header. In the editor it is Card Height, first on each layout's Size & Spacing. Card Dimensions & Scrolling (docs preview)

⏰ Events That Start at Certain Hours

starts_after and starts_before on a calendar keep only those of its timed events that start within those hours, in every layout and in search. They suit a busy shared calendar of which only the afternoon, or only the morning, matters to you.

entities:
  - entity: calendar.volunteer_shifts
    starts_after: '16:00' # only the shifts that start after work
  - calendar.family # keeps all its events

With starts_before earlier than starts_after, the hours run past midnight. All-day events always show. Write each time in quotes. In the editor they are Starts At or After and Starts Before, on a calendar's Which Events page. Showing Events That Start at Certain Hours (docs preview)

📌 Headers Stay While Events Scroll

When a card has less room than its events need, only the events scroll. Grid keeps its day headers, and its all-day band while the two take up to two thirds of the space, while the hours scroll under them. Columns keep their day headers, and the wide Month keeps its weekday row. Card Dimensions & Scrolling (docs preview)

🔘 The View Switcher Folds on a Narrow Card

When the toolbar's top row would no longer fit on one line, the view switcher folds into one button showing the current layout's icon and a ▾. A press opens a menu of the layouts. Nothing wraps onto a second line anymore. Narrow Cards (docs preview)

🗓️ Month Names Its Parts the Same Way Everywhere

The editor calls Month's two forms Wide Month and Narrow Month, the list under a narrow month's weeks the Day List, and the panel "+N more" opens the Day Panel, on every page, in every label and in search. A setting that applies to only one of them says so. On a narrow month, each day's bar grows one colored block per event up to six and then narrows its blocks instead of showing a "+", and the Day List uses the room it has, down to the card's bottom spacing. The Narrow Month (docs preview)

📱 Narrow Cards in the Editor

Size & Spacing has a new Narrow Cards heading (on Month's pages, Wide or Narrow Month). For Columns and Grid, When Too Narrow offers Show fewer days, then a list; Show a list; Keep the days, narrower; or Custom, and replaces Column Density and Grid Density. At Common Card Widths shows what each layout the card can show draws on a phone, in a Sections column, on a tablet and on a desktop, and Month gets its own This card renders table. Narrow Cards (docs preview)

🌐 The Editor Loads Only Your Language

Each editor translation is now a file of its own, loaded only when the editor is drawn in that language. Opening the editor in German downloads about 168 KB instead of about 297 KB, and in English about 154 KB. Dashboards load as before. Every string v6 adds was also reviewed again in all eleven translated editor languages, and the new card strings in every card language. Editor Languages (docs preview)

🔒 The Editor Points Out Hidden Fields Once

Since beta 1, a calendar's Never Show for its location or description no longer hides them in the event details; private: true does. When the editor first opens a card saved by v5, it names each calendar that hid one of them and offers Make It Private, then saves the card as config_version: 6. Upgrading & Going Back (docs preview)

Also Fixed

  • The keyboard can add an event on a wide month's day: with day_tap_action: add-event, the day's name at the top of its panel is an Add event button.
  • Search finds an event merged by filter_duplicates: merge_locations by any of its calendars' locations, and a merged row names every calendar.
  • The editor keeps a calendar's filter_field: title and replace_field: title when you change something else on it.
  • A layout's size written as a bare number at its default, such as column: { event_font_size: 14 }, stays the layout's own in the editor and is no longer removed on the next save.
  • The Now Indicator's help text says it marks only events shorter than a full day.
  • Moving an event by dragging it shows a notice with Undo.
  • Closing an event's details with Back or by tapping outside leaves the event as it was; Save writes your changes.
  • A narrow Columns card without date navigation shows a list instead of dropping days it cannot page to.
  • The month's name on the month rule leaves out the first month only where the toolbar already names it right above.
  • Chinese set as zh-Hans or zh-Hant, as Home Assistant names it, no longer falls back to English.
  • 12-hour times in Chinese, Japanese and Korean use their own word for the time of day.
  • Upgrading a card from before v5 in the editor no longer changes how Columns and Grid draw it.

🔄 What Beta 1 Testers Will Notice

  • "+N more" opens its day panel beside its words in Month. On a narrow month it opened at the far edge of the day's list, and in both forms it sat too high. The popover of an event pressed in the panel opens there too.
  • Grid under a short height stops shrinking its hours at 24 px an hour, or a smaller hour_height, and the events area scrolls below that. Before, the hours shrank without limit and were cut off. The all-day band keeps its rows instead of scrolling on its own, so it is no longer a stop for the Tab key.
  • On a Sections dashboard, every layout fills the rows set in the Layout tab: List scrolls in them, Columns leave room under their days and Grid fits its hours. In beta 1 only Month did.
  • Muted colors keep their hue in Chrome and Edge. With an all-day badge (allday_badge: title or time), the badge's subtle wash of Home Assistant's default blue was pink in Chrome and Edge and is light blue now, as in Safari. Muted calendar colors no longer turn mauve in the badge, in Grid's accent text or in the Now time.
  • A top-level card_height now applies. Beta 1 reported it as misplaced.
  • Card Height in the editor sets the whole card. Choosing Fixed or Maximum clears that layout's height and max_height, which the editor now shows, as Events Area Height and Events Area Maximum Height, only on a card that holds one.
  • Some editor labels are renamed: Visible Event Parts, Card Tap Action and Card Hold Action.
  • The editor arrives as 13 files instead of 2 (see Installing the Beta). In the card's folder you will find editor-de.js, editor-sv.js and the others beside editor.js.
  • Editor text reads differently in places in every translated language after the second review. In German, Month's "+N weitere" is now "+N mehr".

🔍 What to Test

  • A height on a card you use: card_height or a Sections row count, in each layout the card shows, and Grid with a short height in particular.
  • Start hours on a busy calendar, including hours past midnight and an event over several days.
  • "+N more" in Month on a phone and on a tablet, with larger text if you use it.
  • A short card in Grid, Columns or wide Month, scrolled: do the headers stay?
  • The toolbar on a phone with several buttons and the view switcher.
  • Month's editor pages: is it clear which settings change the wide month, the narrow one, the Day List and the Day Panel?
  • Card Height and Narrow Cards in the editor on an existing card. Does At Common Card Widths match what your dashboards draw?
  • The editor in your language opens in it straight away, after a Marketplace or HACS update and after a reload.
  • Chrome or Edge with an all-day badge, or with muted calendar colors.
  • Anything from beta 1's list you have not got to yet.

🚧 Known Gaps

  • The documentation is unfinished. The docs preview describes v6, but pages may change before release.
  • Screenshots and clips still show v5, and Month has no pictures yet.
  • Translations have been reviewed twice, but not by native speakers. Corrections from native speakers are very welcome.
  • No further features are planned for v6.0. What remains before release is fixes, documentation and pictures.

💬 Feedback

Post in the discussion for the beta, or open an issue whose title starts with [v6 beta]. Say which layout, which device and screen width, and paste the card's YAML with real names replaced.

Don't miss a new calendar-card-pro release

NewReleases is sending notifications on new releases.