Skip to main content

Dashboard card

The bundled Home Keeper Tasks card (custom:home-keeper-card) is a resizable list of your tasks with a one-tap Done button on each row. It's a focused do-and-glance surface: mark tasks done, add a new one from the header +, and open any documentation links a task shows (see below) — while editing and deleting a task live in the sidebar panel, so a stray tap on the dashboard can't open a form or accidentally delete a task. It's auto-registered (no resource setup) and appears in the dashboard "Add card" picker. Its GUI editor lets you filter (by status, area, device, label, recurrence type, a "due within N days" horizon, or a saved Profile), sort, group, cap rows, and toggle what each row shows. It's built from HA's own components and theme and reflects completions made anywhere else in real time.

Home Keeper task card grouped into status sections

Show a task's appliance documents on the card​

When a task is attached to an appliance, you can pin any of that appliance's documents — its document links, uploaded files (a PDF manual, a photo), and free-form metadata links (a reorder page, a warranty page, a how-to video) — to the task's row, so the manual or parts page is one tap away while you're actually doing the job. Nothing shows by default; you choose per task.

How to use it:

  • Pick the documents: open the task in the panel's editor and use Links to show on card — a multi-select that lists every document (link or uploaded file) and metadata link on the task's appliance. (The picker only appears once the attached appliance has at least one document.) You can also set them via the home_keeper.add_task / home_keeper.update_task services (card_links).
  • On the card: each chosen document renders as a compact chip on the task's row and opens in a new tab — an uploaded file via a short-lived signed URL. They resolve live — rename or remove one on the appliance and the card follows; a deleted one simply drops off.

Home Keeper task card showing a row with "Owner's manual", "Reorder filter" and an "Installation guide (PDF)" file chip

Filter by label — one card per subject​

Most homes have natural "buckets" of upkeep that don't map onto a room or a single device: the dog, the car, home maintenance, each kid's chores. Tag tasks with Home Assistant labels and point a card at one (or more) of them to get a focused list per subject — a card for the dog, one for the car, one per kid.

A task matches a label filter if the task itself carries the label or its attached device or area does. So labelling a Home Keeper virtual appliance (which is a real device under Settings → Devices) — or any device a task is attached to — automatically pulls its tasks into the matching card, and a subject never has to be modelled as an HA area or device.

How to use it:

  • Tag tasks: open a task's form (in the panel or the card) and pick one or more labels in the Labels field. You can also set labels via the home_keeper.add_task / home_keeper.update_task services.
  • Tag devices (optional): apply the same labels to devices/appliances in Settings → Devices to sweep all their tasks into a card without tagging each one.
  • Point a card at a label: in the card editor set Limit to labels (with an Any/All match mode when you list several), and optionally enable Show labels to render each task's label chips.

Home Keeper card filtered to the "dog" label, showing label chips on each row