Calendar card

Show an iCal (ICS) calendar as a month, week or agenda view.

On this page

Displays a calendar from an ICS link — the standard format used by Google Calendar, Outlook, Apple Calendar and most others.

A Calendar card

Every major calendar can publish a secret address ending in .ics:

  • Google Calendar — Settings → your calendar → Integrate calendarSecret address in iCal format.
  • Outlook / Microsoft 365 — Settings → Calendar → Shared calendars → publish, then copy the ICS link.
  • Apple iCloud — right-click the calendar → Share CalendarPublic Calendar, then copy the link.

That link exposes your calendar to anyone who has it. Keep it private, and if you ever paste it into a screenshot or a forum post, regenerate it in your calendar provider.

Settings

Setting What it does
ICS Link The calendar address. More than one can be added
View Month, Week or Agenda
Title The card's heading

Multiple calendars

Add several ICS links to show them on one card — a family calendar and a work calendar together, for example.

Choosing a view

View Best for Wants
Month An overview of what is coming A large card
Week The next few days in detail A wide card
Agenda "What's next?" A narrow, tall card

Agenda is the most useful view on a phone or a small wall panel — it is a simple list of upcoming events and stays readable at any size.

Tips

  • Month view needs space. A month grid squeezed into a small card is unreadable. If you cannot spare the room, use Agenda.
  • Updates are not instant. ICS is a published file, and calendar providers refresh it on their own schedule. An event added on your phone can take a while to reach the card. This is a property of ICS, not of HDashboards.
  • Check the link if the card is empty. Paste it into a browser: you should get a file download, not a web page or a login screen. A login screen means you copied the wrong address.
Something unclear or out of date? Let us know or ask in the Discord community.