home-assistant.io/source/developers/component_states.markdown

layout, title, description, date, sidebar, comments, sharing, footer

layout	title	description	date	sidebar	comments	sharing	footer
page	Handling states	Instructions how to handle states with your component.	2016-07-01 20:00	true	false	true	true

It is the responsibility of the component to maintain the states of the devices in your domain. Each device should be a single state and, if possible, a group should be provided that tracks the combined state of the devices.

A state can have several attributes that will help the frontend in displaying your state:

• friendly_name: this name will be used as the name of the device
• entity_picture: this picture will be shown instead of the domain icon
• unit_of_measurement: this will be appended to the state in the interface
• hidden: This is a suggestion to the frontend on if the state should be hidden

These attributes are defined in homeassistant.helpers.entity.