home-assistant.io/source/_docs/configuration/entities_domains.markdown
c0ffeeca7 90120afacf
Entity state attribute: merge sections (#34975)
Co-authored-by: Martin Hjelmare <marhje52@gmail.com>
2024-09-30 13:37:11 +02:00

2.4 KiB

title, description, related
title description related
Entities and domains Describes what entities and domains are in Home Assistant.
docs title
/docs/configuration/state_object/ State object, entity state and attributes

Your devices are represented in Home Assistant as entities. Entities are the basic building blocks to hold data in Home Assistant. An entity represents a {% term sensor %}, actor, or function in Home Assistant. Entities are used to monitor physical properties or to control other entities. An entity is usually part of a {% term device %} or a {% term service %}. Entities have states and state attributes.

All your entities are listed in the entities table, under {% my entities title="Settings > Devices & services > Entities" %}.

Screenshot showing the Entities tableScreenshot of the Entities table. Each line represents an entity.

Domains

Each integration in Home Assistant has a unique identifier: a domain. All entities and actions available in Home Assistant are provided by integrations and thus belong to such a domain. The first part of the entity or action, before the . shows the domain they belong to. For example, light.bed_light is an entity in the light domain. bed_light is the ID of the entity.

The domain provides entities, services, and other functionality that other integrations can use. For example, IKEA and Philips Hue both use functionalities provided by the light integration. This is why the look and feel and behavior is similar in Home Assistant.

There are different types of domains: integration domains and entity domains:

  • Integration domains provide functionality primarily for itself: examples are Hue, Matter, or Zigbee.
  • Entity domains don't use their own functionality as such. But they provide it for other integrations to use.

The integrations listed below are used as entity domains. They are also referred to as building block integrations or entity integrations:

    {%- for integration in site.integrations %}
    {%- if integration.ha_integration_type == "entity" %}
        {%- assign name = integration.title -%}
        {%- assign target = integration.ha_domain | prepend: "/integrations/" -%}
    
        <li><a href="{{target}}">{{name}}</a></li>
    
    {%- endif -%}
    

    {%- endfor %}