Decluttering Card Plus Contents ↓ GitHub ↗

Installation

Requirements

You do not need card-mod, lovelace-card-templater or any other helper — see Styling.

Option 1 — HACS (recommended)

  1. Open HACS in the Home Assistant sidebar.
  2. Search for Decluttering Card Plus.
  3. If it is not listed, add this repository as a custom repository: ⋮ → Custom repositories, URL https://github.com/tempus2016/decluttering-card-plus, type Dashboard.
  4. Click Download.
  5. Reload your browser with a hard refresh (Ctrl+Shift+R, or Cmd+Shift+R on a Mac).

HACS registers the dashboard resource for you.

Open your Home Assistant instance and open a repository inside the Home Assistant Community Store.

Option 2 — manual

  1. Download decluttering-card-plus.js from the repository.

  2. Put it in <config>/www/decluttering-card-plus.js on your Home Assistant machine.

    wget https://raw.githubusercontent.com/tempus2016/decluttering-card-plus/main/dist/decluttering-card-plus.js
mv decluttering-card-plus.js /config/www/

  3. Register it as a dashboard resource.

    In the UI: Settings → Dashboards → ⋮ → Resources → + Add resource, URL /local/decluttering-card-plus.js, type JavaScript module.

    In YAML mode, in your ui-lovelace.yaml:

    resources:
  - url: /local/decluttering-card-plus.js
    type: module
  4. Hard refresh your browser.

/config/www is served at /local. If you have just created the www folder, restart Home Assistant — the static path is only registered at startup, so until you do the file will 404.

Confirming it loaded

Open your dashboard, press F12 and look at the browser console. The card announces itself:

 DECLUTTERING-CARD-PLUS
   Version 1.0.0

You can also check the card picker. Edit any dashboard, click + Add card and search for declutter:

The card picker showing all four registered card types

You should see four entries:

Entry What it is
Decluttering Card Plus Use a template. This is the one you will add most often.
Decluttering Template Plus Define a template as a card.
Decluttering Card (compatibility) Alias so existing custom:decluttering-card config keeps working.
Decluttering Template (compatibility) Alias for existing custom:decluttering-template config.

The two compatibility entries only appear when the original decluttering-card is not installed — see Migrating from decluttering-card.

If nothing shows up at all, go to Troubleshooting.

Next

→ Quick Start