Home AssistantHome AssistantContributors

    ↑↓ to moveEnter to openEsc to close

    Registry

    Where Home Assistant keeps what it knows about entities, devices, areas, floors, and labels, and what users changed about them.

    In code
    er.async_getdr.async_getentity_registrydevice_registry
    Also
    registries, entity registry, device registry

    There is one registry for each: the entity registry, the device registry, the area registry, and so on. They are stored in .storage and survive restarts.

    Users' changes live in the registries, not in integrations. When a user renames an entity, the integration does not need to know.

    Related terms

    • Unique IDAn ID that an integration gives an entity or config entry, which never changes, so Home Assistant recognizes it after a restart.
    • DeviceA physical device, or a service, that one or more entities belong to, like a thermostat with a temperature sensor and a humidity sensor.
    • AreaA room or space in the home, like the kitchen, that devices and entities belong to.
    • LabelA tag users put on entities, devices, areas, automations, and more, to group them their own way, like everything that uses a lot of energy.