Customizing entities

After adding a new device, you might find the automatically assigned entity ID too technical and the entity lacking a friendly name. You can personalize these elements to better fit your naming conventions or modify other attributes like the icon.

To change entity attributes, follow these steps:

1. Go to Settings > Devices & services > Entities and select the entity from the list.

2. In the top-right corner, select the cog icon.

   

3. Enter or edit the attributes:

   • For example, the entity ID here could be shortened to binary_sensor.lumi_sensor_aq2_opening.

     • You can use lowercase letters, numbers, and underscores.
     • The ID must not start or end with an underscore.
     • To undo the change and revert the ID to the default, select the icon.
     • To revert all the entity IDs for a device, on the device page, select the three dots menu, then select Recreate entity IDs.
     • Result: This resets the entity ID and applies the current default naming convention.
       • The terms used to generate the entity ID depend on a few factors. Prioritization is as follows:
         1. If you changed the name of the entity, the entity name will be used.
         2. The entity ID suggested by the integration (just a few integrations do this).
         3. The default name in the user language, if using Latin script.
            • If something other than Latin script is used, the entity ID is based on the English default name. This is because entity IDs must use lowercase letters, numbers, and underscores.

   • Enter or edit the entity name.

     • In this example, this would change “Opening”.

   • If needed, from the Shown as menu, you can select a different device class.

   • If you like, add a label.

   

4. To apply the changes, select Update.

5. If you changed the entity ID and use this entity in automations or scripts, update the entity ID there as well.

   • Changing only the entity name does not affect your automations or scripts because they refer to the entity ID.
   • Go to Settings > Automations & scenes, open the respective tab, and find your automation or script.

Changing the entity ID format for new entities

Home Assistant generates entity IDs for new entities based on parts of your setup, like the floor, area, device, and entity name. For example, a temperature sensor on a thermostat in the living room might become sensor.living_room_thermostat_temperature.

You can change which parts are used and in which order. This format is only used when Home Assistant generates a new entity ID, so existing entities keep their current entity IDs, and you can still rename them afterwards in the entity settings.

To change the format:

1. Go to Settings > System > Entity ID format.
2. Add, remove, or reorder the Floor, Area, Device, and Entity parts to build the format you want. The Preview shows an example of the result.
3. Select Save.

The default format uses the area, device, and entity name, in that order. To go back to it, select Reset to default.

When you recreate the entity IDs for a device, Home Assistant uses this format to generate them.

Customizing an entity in YAML

If your entity is not supported, or you could not customize what you need via the user interface, you need to edit the settings in your configuration.yamlThe configuration.yaml file is the main configuration file for Home Assistant. It lists the integrations to be loaded and their specific configurations. In some cases, the configuration needs to be edited manually directly in the configuration.yaml file. Most integrations can be configured in the UI. [Learn more] file. For a detailed description of the entity configuration variables and device class information, refer to the Home Assistant Core integration documentation.