Waste Card

Features

• Two cards: a full Waste Card (custom:waste-card) and a compact Waste Mini Card (custom:waste-mini-card, next collection only)
• Drawn wheelie bins of the next collection, in the color of their type with its icon on the front, animated by what is due: rolled to the kerb under the moon the evening before, lids lifting with pulsing rings on collection day (see Animations)
• Countdown worded in your language (Today, Tomorrow, In 3 days, Übermorgen…), and the date of the collection
• Put out tonight: the day before a collection the card highlights the bins to take out, from the hour you choose (tonight_from); Collection today on the day itself
• Next collection per bin type: one tile per type with its countdown and date, the ones due today or tomorrow outlined
• Upcoming collections: the next collection days with their bins
• Header icon and status chip colored by the next collection: blue today, orange tomorrow, green later
• Several sources in one card (a Waste Collection Schedule sensor, a calendar, a date sensor…): the same collection given by two of them is shown once
• Waste categories recognized in many languages: household waste, recycling / packaging, paper, glass, organic, garden waste, bulky waste, hazardous waste, textiles, electronics; names as given by the source, or the translated category (type_names: category)
• Own name, color and icon per type (types), or per entity
• Collapsible sections, folded back by a click anywhere else on the page
• Detail button on the mini card (top right): it switches the mini card to the full card's content and back; a click anywhere outside the card brings the compact view back
• Click a collection to open the Home Assistant more-info of its entity
• Visual editor in the dashboard UI for both cards (no YAML needed), every option also in YAML
• Light and dark mode, English, French, German, Spanish, Serbian (Cyrillic and Latin), Italian, Dutch, European Portuguese, Polish, Romanian, Danish, Swedish, Bulgarian, Russian, Ukrainian, Hungarian, Slovak, Czech, Slovenian, Latvian and Greek
• Single file, no external dependency; each language other than English is a small file loaded only when needed

Supported integrations

Source	Entities	What the cards read
Waste Collection Schedule (custom)	sensor and calendar entities of the integration — found automatically when entities is not set	Sensors: every details_format — upcoming (one attribute per date), appointment_types (one attribute per type), generic (upcoming list) — and, with hidden, the state (Paper, Glass in 2 days, or your value_template with add_days_to). Calendars: their events
Any calendar integration — Local Calendar, Google Calendar, CalDAV, Remote Calendar (an ICS feed of your municipality)…	calendar entities	The events of the next days (60 by default), through the calendar REST API or, when it is not available, the calendar.get_events action; the summary is the collection type (Paper, Glass gives two collections; the calendars of Waste Collection Schedule hold one type per event and are not split)
Any sensor whose state is a date — a template sensor, another waste integration…	sensor entities	A date (2026-11-14, 14.11.2026), a timestamp (device_class: timestamp), or a number of days (unit d / days, or a daysTo attribute). The collection type is the entity's name, or the name / type set on the entity

Prerequisites

Home Assistant 2024.8 or later, with at least one of the supported sources.

Configuration

Card types#

Visual editor#

Edit a dashboard, click Add card and search for Waste Card or Waste Mini Card. The sensors and calendars of Waste Collection Schedule are preselected; pick other entities in the list, set an optional title, the hour of the evening highlight, the sections and the language. The preview updates live, and options left at their default are kept out of the generated YAML. Per-type names, colors and icons (types) and per-entity settings are set in YAML; the editor keeps them.

Minimal#

With Waste Collection Schedule, nothing to set: its sensors and calendars are found on their own.

type: custom:waste-card

type: custom:waste-mini-card
entities:
  - sensor.waste_collection

Full options#

type: custom:waste-card
title: Bins
entities:
  - sensor.waste_collection          # Waste Collection Schedule
  - calendar.municipal_collections   # any calendar
  - entity: sensor.bulky_waste_date  # a date sensor, with its own settings
    name: Bulky waste
    type: bulky
type_names: source
types:
  - match: Recycling                 # text contained in the collection type (case and accents ignored)
    name: Yellow bin
    color: "#fdd835"
  - match: /organic|garden/          # or a regular expression
    name: Brown bin
    color: "#8d6e63"
    icon: mdi:leaf
  - match: Glass
    category: glass
    icon: mdi:bottle-wine
tonight_from: 16
show_title: true
show_subtitle: true
show_bins: true
show_upcoming: true
max_items: 6
days: 60
collapsed:
  - upcoming
language: en

type: custom:waste-mini-card
entities:
  - sensor.waste_collection
title: Bins
tonight_from: 16
zoom: true
language: en

Options reference#

Waste categories#

The category of a collection type gives its default icon and color. It is recognized from the type's name in many languages, or set with category (in types) or type (on an entity):

Bin colors differ from one town to another: set yours with types.

How it works

Each entity gives a list of collections (a day and a type):

• Waste Collection Schedule sensors: the attributes, whatever the details_format — upcoming (2026-11-14: Recycling, Glass, split on the separator), appointment_types (Recycling: 2026-11-14) or generic (upcoming: [{date, type}]); with hidden, the state: the default Recycling, Glass in 1 days, or a value_template giving the types together with the daysTo attribute (add_days_to: true). Dates rendered by a date_template are read as YYYY-MM-DD, DD.MM.YYYY or DD/MM/YYYY.
• Calendars: the events of the next days, read once and again when the calendar's state changes (its next event moved) or after an hour; until they arrive, the calendar's own next event.
• Date sensors: the state as a date, a timestamp (converted to your local day) or a number of days, counted from the day the state was written.

Days follow the time zone of your Home Assistant profile (your browser's, or the server's when the profile says so). Collections before today are left out; the same type on the same day from two entities is shown once. The countdown and the evening highlight follow the clock (checked every minute), so the card turns from Tomorrow to Today at midnight on its own.

The countdown and dates are formatted by the browser's Intl in the card's language, so plurals and words like the day after tomorrow are right in every language.

Fixes

• Folding back on a tap elsewhere now works on iOS (Safari and the companion app): a tap on something that is not clickable sent no click to the page, so the unfolded sections of the card and the detailed view of the mini card stayed open. The press and the release are caught instead; a slider dragged out of the card and a scroll do not fold anything.
• Leaving the card (another dashboard view, a conditional card hidden) brings it back in its default state: sections folded as configured, mini card compact.
• A click could do nothing: Home Assistant updates the card several times a second, and a rewrite of the card between the press and the release replaced the element pressed, so that the click was lost. The card is no longer rewritten while a press is in progress; the pending update is drawn right after the click.
• No focus ring after a mouse click or a tap: the focus is kept across updates only for the keyboard.

Features

• custom:waste-card: next collection with drawn wheelie bins in the color of their type, countdown (today / tomorrow / in N days) and date; "Put out tonight" highlight the day before (tonight_from) and "Collection today" on the day; next collection per bin type; list of the next collection days (max_items); collapsible sections (collapsed), folded back by a click elsewhere.
• custom:waste-mini-card: next collection only, with a detail button switching to the full card and back (zoom).
• Sources: Waste Collection Schedule sensors (every details_format, or the state) and calendars, found automatically; any calendar entity (REST API, or the calendar.get_events action); any sensor whose state is a date, a timestamp or a number of days.
• Waste categories recognized in many languages (household, recycling, paper, glass, organic, garden, bulky, hazardous, textiles, electronics), giving the default icon and color; own name, category, icon and color per type (types) or per entity; type names as given by the source or translated (type_names).
• Animations: the bins roll to the kerb under the moon the evening before a collection, their lids lift with pulsing rings on collection day; prefers-reduced-motion honoured.
• Visual editors for both cards; light and dark themes; 22 languages, every language but English loaded on demand.