Device card
Open Source

Device card

2025·Open Source / Community

Overview

Generic device summary card that rolls manufacturer, connectivity, battery, firmware, and key related entities into a single Lovelace card template. Cuts down repetitive per-device YAML and keeps device drill-downs consistent across integrations. Built with TypeScript for Home Assistant’s Lovelace stack, distributed through HACS, and actively used across the homeassistant-extras ecosystem.

README

<p align="center"> <img src="docs/assets/cards.png" align="center" width="50%"> </p> <p align="center"><h1 align="center">Device Card</h1></p> <p align="center"> <em>A comprehensive card to display and organize your Home Assistant device entities</em> </p>

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

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

  • Built using LitElement
  • Inspired by Home Assistant's chip design
  • Thanks to all contributors!

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
  • 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