Chapter 4

Naming and labels

Replace an opaque ID such as switch.0x00abc123_2 with a clear name such as “Living Room Main Light.” Good names make voice control, dashboards, and automations easier to understand. Labels then let you manage related items as a group, which the source describes as making maintenance 10 times faster.

Why names matter

A newly paired device may use a technical name supplied by its manufacturer, for example:

  • light.aqara_light_group_2
  • switch.0x00158d000abcd1234
  • sensor.motion_sensor_ambient_temperature

Names like these cause two problems:

  1. Voice commands become unnatural. You do not want to say, “Turn on aqara_light_group_2.”
  2. Other people cannot identify controls. A dashboard full of technical IDs is difficult to use confidently.

Replace them with the names you naturally use at home.

Understand the three names

Home Assistant has three related names that are easy to confuse:

  • Device name: The name of the complete device, such as “Living Room Ceiling Light.”
  • Entity ID: The internal identifier used in configuration, such as light.living_room_ceiling. Use this in automations.
  • Friendly name: The label displayed in the interface, such as “Main Light.” Use this for display and voice control.
Concept: Give the device a complete name, such as “Living Room Ceiling Light,” and the entity a short friendly name, such as “Main Light.” When Home Assistant adds the area, the result reads naturally as “Living Room Main Light.”

Rename an entity

Version note: Before 2026.2, Developer tools was a separate sidebar item. It moved under Settings in 2026.2 and was shortened to Tools in 2026.8. The internal pages, including States and Templates, remain the same.

  1. Open the entity list

    Go to Settings → Devices & services → Entities. Use the search field to find the entity you want.

    Entity list with status, name, and entity ID
    Figure 4-1 Each row in the entity list shows an entity’s status, name, and entity ID.

  2. Open the entity settings

    Select the entity, then select the gear in the upper-right corner of its details.

  3. Change the Name field

    This changes the friendly name. The entity ID remains unchanged, so references to it continue to work.

    Entity settings with name and entity ID fields
    Figure 4-2 Name is the friendly name. Home Assistant warns you before changing Entity ID.

  4. Decide whether to change the entity ID

    Change it early when useful. If the device is new and no automation references it yet, choose a meaningful alphanumeric ID such as light.living_room_main. Your configuration will be easier to read later.

    Warning: Before changing an ID already used by automations, scripts, or dashboards, find and review those references. You can inspect the current entity under Settings → Tools → States.
Verify: Search for the new ID under Settings → Tools → States. The old entity_id should no longer appear. Warning: Changing an entity_id can break any automation that still references the old value. Chapter 8 explains why planning IDs early matters.

Organize items with labels

An area answers “Where is this light?” A label answers “What kind of item is this?” For example:

  • Apply a Lighting label to lights so you can target all lighting together.
  • Apply a Backup power label to USB-powered devices that remain powered during an outage.
  • Apply a Tenant access label to items a tenant may use, then filter for that label when building a dashboard.

  1. Create a label under Settings → Areas, labels & zones → Labels

    Labels management page
    Figure 4-3 Each label can have its own color and icon.

  2. Apply a label to entities

    Select several entities in the entity list, then use Add label to apply one label to all of them.

  3. Use labels elsewhere

    Labels work on more than entities. You can apply them to areas, devices, entities, automations, scripts, scenes, and helpers. An item can have several labels, while it can belong to only one area.

    Use labels in automation targets, dashboard filters, and scripts instead of maintaining a list of individual entities. If an entity changes but its label remains, the group is easier to maintain.

Naming examples

Type Friendly name Entity ID
LightMain Lightlight.living_room_main
LightAmbient Lightlight.living_room_ambient
SwitchWater Dispenserswitch.kitchen_water_dispenser
Occupancy sensorOccupancybinary_sensor.master_bedroom_occupancy
ClimateAir Conditionerclimate.master_bedroom_ac
Next step: Chapter 6 shows how to place frequently used entities on a dashboard. Chapter 8 uses these names in your first automation.

Categories: another classification tool

Home Assistant introduced categories in 2024.04. They serve a different purpose from labels:

Comparison Labels Categories
Where they applyAreas, devices, entities, automations, scripts, scenes, and helpersAutomations, scripts, scenes, and helpers only
Automation targetYesNo; categories organize lists in the interface
Typical use“All living-room lights” or “All security devices”“Lighting,” “Ambience,” or “Security” for easier browsing
Concept: Use labels when an automation needs the group. Use categories when you only need to organize a list in the interface.

FAQ

Will Home Assistant update old automations when I change an entity ID?
Home Assistant can update references in automations created through the UI when you rename an entity. You must search for and replace references in hand-written YAML and Node-RED flows yourself.
What is the difference between a label and an area?
An area describes location. A label describes a property, audience, or purpose. A device can belong to one area but can have multiple labels.
Can friendly names be duplicated?
Yes. Identical friendly names in different areas do not conflict because Home Assistant can display the area prefix. Voice assistants may still have trouble distinguishing them, so unique names are safer.

Troubleshooting

Why did an automation stop after I changed an entity_id?
The automation probably still references the old entity_id. Review your automations under Settings → Automations & scenes, and search templates or configuration for the old value. In current versions, templates are under Settings → Tools → Templates; earlier versions place Developer tools in the sidebar. Chapter 8 explains why targeting entity_id instead of device_id makes device replacements easier to manage.
How do friendly name and entity_id differ?
The friendly name is the display name in the UI, such as “Living Room Main Light.” You can usually change it without breaking anything. The entity_id is the system identifier, such as light.living_room_main. Changing it affects automations, dashboards, and scripts that reference the old value. For routine display changes, change only the friendly name.
Can I rename several entities at once?
Home Assistant does not provide a batch-renaming UI. Directly editing .storage/core.entity_registry is risky and not recommended. Third-party bulk-renaming tools may be available through HACS, but their support can change. The safest approach is to finish naming each new device before you configure the next one.