Customizing Devices and Services

By default, all of your devices will be visible and have a default icon determined by their domain. You can customize the look and feel of your front page by altering some of these parameters. This can be done by overriding attributes of specific entities.

# Example configuration.yaml entry
  name: Home
  unit_system: metric
  # etc

    # Only the 'entity_id' is required.  All other options are optional.
      hidden: true
      friendly_name: Nest
      friendly_name: Toaster
      entity_picture: /local/toaster.jpg
      friendly_name: Kitchen kettle
      icon: mdi:kettle
      assumed_state: false

Possible values

Attribute Description
friendly_name Name of the entity
hidden Set to true to hide the entity.
entity_picture Url to use as picture for entity
icon Any icon from Prefix name with mdi:, ie mdi:home.
assumed_state For switches with an assumed state two buttons are shown (turn off, turn on) instead of a switch. By setting assumed_state to false you will get the default switch icon.
sensor_class Sets the class of the sensor, changing the device state and icon that is displayed on the UI (see below).
sensor_class Description
cold On means cold (or too cold)
connectivity On means connection present, Off means no connection
gas CO, CO2, etc.
heat On means hot (or too hot)
light Lightness threshold
moisture Specifically a wetness sensor
motion Motion sensor
moving On means moving, Off means stopped
occupancy On means occupied, Off means not occupied
opening Door, window, etc.
power Power, over-current, etc.
safety On means unsafe, Off means safe
smoke Smoke detector
sound On means sound detected, Off means no sound
vibration On means vibration detected, Off means no vibration

Reloading customize

Home Assistant offers a service to reload the core configuration while Home Assistant is running called homeassistant/reload_core_config. This allows you to change your customize section and see it being applied without having to restart Home Assistant. To call this service, go to the service developer tool icon service developer tools, select the service homeassistant/reload_core_config and click “Call Service”.

New customize information will be applied the next time the state of the entity gets updated.

Next step: Setting up presence detection »