Skip to content

Latest commit

 

History

149 Commits

Folders and files

Repository files navigation

Device Card

A comprehensive card to display and organize your Home Assistant device entities

Device Card

Home Assistant hacs_badge

GitHub Release GitHub Pre-Release GitHub Tag GitHub branch status

stars home commits license

Overview

A custom card for Home Assistant that provides a comprehensive overview of any device in your system. The card organizes device information into expandable sections. An Integration Card variant displays all devices from a selected integration domain.

Documentation

Full documentation is available at: homeassistant-extras.github.io/device-card

Quick Start

Device Card

type: custom:device-card
device_id: YOUR_DEVICE_ID

Or use an entity ID and the card will automatically determine the device:

type: custom:device-card
entity_id: sensor.your_entity_id

Integration Card

type: custom:integration-card
integration: zwave_js

Installation

Requires Home Assistant 2026.11.0 or newer.

HACS (Recommended)

HACS

  1. Open HACS in your Home Assistant instance
  2. Click the menu icon in the top right and select "Custom repositories"
  3. Add: https://github.com/homeassistant-extras/device-card
  4. Select "Dashboard" as the category
  5. Click "Install"

Manual Installation

  1. Download device-card.js from the latest release
  2. Copy to www/community/device-card/
  3. Add to your configuration.yaml:
lovelace:
  resources:
    - url: /local/community/device-card/device-card.js
      type: module

Contributing

License

This project is protected under the MIT License. For more details, refer to the LICENSE file.

Acknowledgments

contributors

ko-fi

Project Roadmap

  • Initial design: Create initial card design
  • Enhanced customization: Add more customization options
  • Custom section order and exclusions: Set the order in which sections are displayed & exclude things - thanks @andrewjswan
  • Entity interactions: Configure tap, hold, and double-tap actions - thanks @andrewjswan
  • Status badges: Quick status badges for device state
  • Entity filtering: Filter specific entities from display - thanks @andrewjswan, @TTLucian
  • Integration Card: Rollup to see all devices - thanks @andrewjswan
  • Hide device model: Option to hide device model information - thanks @andrewjswan
  • Compact layout: Space-efficient layout option - thanks @andrewjswan
  • Column control: Ability to define column count for integration card - thanks @andrewjswan
  • Device exclusion: Ability to exclude devices from integration card - thanks @andrewjswan
  • Wildcard/regex filtering: Exclude devices/entities by wildcard or regex patterns - thanks @andrewjswan
  • Device inclusion: Include only specific devices option - thanks @andrewjswan
  • Entity & device sorting: Add ability to sort entities - thanks @andrewjswan, @rudi159
  • Card expansion: Ability to expand/collapse the device card - thanks @fgamache1, @joshua-beck-0908
  • Pinned entity state: Add pinned state entity display - thanks @fgamache1
  • Integration title control: Modify/hide integration card title - thanks @andrewjswan
  • Hide title feature: Device card can remove title
  • Section exclusion: Add ability to exclude sections - thanks @ctallc
  • Entity ID support: Alternative to device_id - card automatically determines device - thanks @potat0man
  • Random bugs & improvements: pointing out issues to improve card - thanks @PedroKTFC, @misc-brabs!
  • Translations / Localization: support for multiple languages and localized text - thanks @Bsector
  • Inverse percent colors: Invert percent bar colors for entities like disk usage - thanks @misc-brabs
  • Jinja template support: Certain config properties support Jinja - thanks @LenirSantiago
  • Auto-entities support: entity config property for auto-entities integration - thanks @misc-brabs
  • Heading icon: Entity icon next to card heading when entity_id/entity is configured - thanks @LennartPl
  • More-info from attributes: Tap an entity's attribute details to open its more-info dialog - thanks @mleiber
  • Custom percent colors: Solid colors or custom thresholds for percent bars - thanks @ki1isu

Releases

Packages

Used by

Contributors

Languages