Entity Filter Card


This card allows you to define a list of entities that you want to track only when in a certain state. Very useful for showing lights that you forgot to turn off or show a list of people only when they’re at home.

This type of card can also be used together with rest of cards that allow multiple entities, allowing you to use glance or picture-glance. By default it uses entities card model.

Screenshot of the entity filter card Screenshot of the entity filter card.

Configuration Variables

type

(string)(Required)

entity-filter

entities

(list)(Required)

A list of entity IDs or entity objects, see below.

state_filter

(list)(Required)

List of strings representing states or filter objects, see below.

card

(map)(Optional)

Extra options to pass down to the card rendering the result.

Default value:

entities card

show_empty

(boolean)(Optional)

Allows hiding of card when no entities returned by filter.

Default value:

true

Options For Entities

If you define entities as objects instead of strings (by adding entity: before entity ID), you can add more customization and configurations:

Configuration Variables

entity

(string)(Required)

Home Assistant entity ID.

type

(string)(Optional)

Sets a custom card type: custom:my-custom-card

name

(string)(Optional)

Overwrites friendly name.

icon

(string)(Optional)

Overwrites icon or entity picture.

secondary_info

(string)(Optional)

Show additional info. Values: entity-id, last-changed.

format

(string)(Optional)

How the state should be formatted. Currently only used for timestamp sensors. Valid values are: relative, total, date, time and datetime.

state_filter

(list)(Optional)

List of strings representing states or filter objects, see below.

Options For state_filter

If you define state_filter as objects instead of strings (by adding value: before your state value), you can add more customization to your filter:

Configuration Variables

value

(string)(Required)

String representing the state.

operator

(string)(Optional)

Operator to use in the comparison. Can be ==, <=, <, >=, >, != or regex.

attribute

(string)(Optional)

Attribute of the entity to use instead of the state.

Examples

Show only active switches or lights in the house

type: entity-filter
entities:
  - entity: light.bed_light
    name: Bed
  - light.kitchen_lights
  - light.ceiling_lights
state_filter:
  - "on"

Show only people that are at home using glance:

type: entity-filter
entities:
  - device_tracker.demo_paulus
  - device_tracker.demo_anne_therese
  - device_tracker.demo_home_boy
state_filter:
  - home
card:
  type: glance
  title: People at home

Specify filter for a single entity

type: entity-filter
state_filter:
  - "on"
  - operator: ">"
    value: 90
entities:
  - sensor.water_leak
  - sensor.outside_temp
  - entity: sensor.humidity_and_temp
    state_filter:
      - operator: ">"
        value: 50
        attribute: humidity

Entity filter combined with glance card Entity filter combined with glance card.