Customizing entities


Changing entity name and entity ID

After adding a new device, the entity may not have a name and the automatically assigned entity ID might look very technical. If you like, you can use your own naming concept for devices.

To change the entity ID and friendly name of supported entities, 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.

    Entity dialog box with cog icon.

  3. Enter the new name or the new entity ID.

    • For example, the entity ID here could be light.bedroom_lightstrip_3.
    • Do not change the domain of the entity - the part before the . (period).
    • You can use lowercase letters, numbers, and underscores.
    • The name must not start or end with an underscore.

    Settings for entity.

  4. Select Update.

  5. If you have used this entity in automations and scripts, you need to rename the entity ID there, too.

    Edit entity ID in automation.

If your entity is not supported, or you cannot customize what you need via this method, 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.