mirror of
https://github.com/home-assistant/home-assistant.io.git
synced 2025-07-18 23:06:58 +00:00
Customize entity: add step to revert entity ID to default (#39495)
This commit is contained in:
parent
0aade54e18
commit
c3bcc49cdd
@ -9,23 +9,35 @@ related:
|
|||||||
- docs: /docs/organizing/labels/
|
- docs: /docs/organizing/labels/
|
||||||
---
|
---
|
||||||
|
|
||||||
## Customizing an entity
|
|
||||||
|
|
||||||
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.
|
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:
|
To change entity attributes, follow these steps:
|
||||||
|
|
||||||
1. Go to {% my entities title="**Settings** > **Devices & services** > **Entities**" %} and select the entity from the list.
|
1. Go to {% my entities title="**Settings** > **Devices & services** > **Entities**" %} and select the entity from the list.
|
||||||
2. In the top right corner, select the cog icon.
|
2. In the top-right corner, select the {% icon "mdi:cog" %} cog icon.
|
||||||
|
|
||||||

|

|
||||||
|
|
||||||
3. Enter or edit the attributes:
|
3. Enter or edit the attributes:
|
||||||
- For example, the entity ID here could be shortened to `binary_sensor.living_room_motion_1`.
|
- For example, the entity ID here could be shortened to `binary_sensor.lumi_sensor_aq2_opening`.
|
||||||
- Do not change the domain of the entity - the part before the `.` (binary_sensor, in this example).
|
|
||||||
- You can use lowercase letters, numbers, and underscores.
|
- You can use lowercase letters, numbers, and underscores.
|
||||||
- The ID must not start or end with an underscore.
|
- The ID must not start or end with an underscore.
|
||||||
|
- To undo the change and revert the ID to the default, select the {% icon "mdi:restore" %} icon.
|
||||||
|
- **Note**: You can only reset the ID to the default ID for entities with a unique ID.
|
||||||
|
- IDs of entities that are disabled or for which the integration is not set up cannot be reverted.
|
||||||
|
- To revert all the entity IDs for a device, on the device page, select the three dots {% icon "mdi:dots-vertical" %} 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 depends on a few factors. Prioritization is as follows:
|
||||||
|
1. If you changed the friendly name of the entity, the friendly 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 the 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 alphanumeric characters in the range of [a-z,1-9].
|
||||||
|
|
||||||
|

|
||||||
|
|
||||||
- Enter or edit the friendly name.
|
- Enter or edit the friendly name.
|
||||||
|
- In this example, this would change "Opening".
|
||||||
- If needed, from the **Shown as** menu, you can select a different [device class](/integrations/homeassistant/#device-class).
|
- If needed, from the **Shown as** menu, you can select a different [device class](/integrations/homeassistant/#device-class).
|
||||||
- If you like, add a [label](/docs/organizing/labels/).
|
- If you like, add a [label](/docs/organizing/labels/).
|
||||||
|
|
||||||
|
Binary file not shown.
Before Width: | Height: | Size: 30 KiB After Width: | Height: | Size: 31 KiB |
Binary file not shown.
Before Width: | Height: | Size: 69 KiB After Width: | Height: | Size: 81 KiB |
Loading…
x
Reference in New Issue
Block a user