diff --git a/source/_docs/configuration/customizing-devices.markdown b/source/_docs/configuration/customizing-devices.markdown
index 1c820912887..d39bb0e3976 100644
--- a/source/_docs/configuration/customizing-devices.markdown
+++ b/source/_docs/configuration/customizing-devices.markdown
@@ -5,6 +5,7 @@ related:
   - docs: /integrations/homeassistant/
   - docs: /docs/configuration/
     title: configuration.yaml file
+  - docs: /docs/configuration/troubleshooting/
 ---
 
 ## Changing entity name and entity ID
@@ -19,8 +20,10 @@ To change the entity ID and friendly name of supported entities, follow these st
    ![Entity dialog box with cog icon.](/images/docs/configuration/customizing-entity-dialog.png)
 
 3. Enter the new name or the new entity ID.
-   - For example, the entity ID here could be `light.bedroom_ligthstrip`.
-   - Do not change the domain of the entity - the part before the `.`.
+   - 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.](/images/docs/configuration/customizing-entity.png)