From e2f470ceff841c5a3163b4dc3871178e65238028 Mon Sep 17 00:00:00 2001 From: Philip Allgaier Date: Wed, 27 Jan 2021 12:35:56 +0100 Subject: [PATCH] Improve and update FAQ entry for unique ID (#16260) Co-authored-by: Franck Nijhof --- source/_faq/unique_id.markdown | 36 +++++++++++++++++++++---- source/images/faq/faq_no_unique_id.jpg | Bin 0 -> 41156 bytes 2 files changed, 31 insertions(+), 5 deletions(-) create mode 100644 source/images/faq/faq_no_unique_id.jpg diff --git a/source/_faq/unique_id.markdown b/source/_faq/unique_id.markdown index 429e9432247..954f1e8c2ed 100644 --- a/source/_faq/unique_id.markdown +++ b/source/_faq/unique_id.markdown @@ -4,10 +4,36 @@ description: "This entity does not have a unique ID?" ha_category: Configuration --- -When you see +If you try to access the configuration dialog for an entity in your Home Assistant, you might end up seeing this message: -```text -This entity does not have a unique ID, therefore its settings cannot be managed from the UI -``` +![Screenshot of popup for no unique ID](/images/faq/faq_no_unique_id.jpg) -this simply means that you can't change the `entity_id` or the friendly name from the UI. You can still use the _Customizations_ menu to customize that entity. Typically you'll see this when you create entities using YAML. +This means that this entity does not have a unique identification, e.g., a serial number or another identifier that is guaranteed to be static and never changes. As a result, the normal editing process that allows you to change various settings through the user interface (such as the entity ID, icon, friendly name, etc.) is not possible here. + +Typically, you'll see this when you create entities manually using YAML, but it can also appear if the integration that provides this entity, cannot determine a unique ID. This however is not an error, but just a limitation of the integration you use. A few selected integrations (such as [`template`](/integrations/template/) and [`mqtt`](/integrations/mqtt/)) allow the user to define a unique ID. + +### Used where? + +**Unique ID:** + +- Only internally in Home Assistant. + +**Entity ID:** + +- Entity with a unique ID: Entity ID only used as a reference, e.g., in automations or dashboards. +- Entity without a unique ID: Entity ID acts as the replacement for the non-existing unique ID plus as a reference, e.g., in automations or dashboards. + +### Can be changed? + +**Unique ID:** + +- No. It is a static identifier. + +**Entity ID:** + +- Entity with a unique ID: Entity ID can be adjusted freely (as long as it follows the format `.` and does not result in duplicates in your Home Assistant). Keep in mind that if you change the entity ID, you also need to update the references, e.g., in automations and dashboards.
+- Entity without a unique ID: Entity ID is considered a fixed, static identifier and cannot be changed. + +If your user profile has the "Advanced Mode" activated, you will also see the second paragraph in the popup with a link to the [customization user interface](/docs/configuration/customizing-devices/#customization-using-the-ui) for this specific entity, which offers some customization options. + +In case you want to read more about unique IDs, head over to this [developer documentation page](/docs/entity_registry_index/). diff --git a/source/images/faq/faq_no_unique_id.jpg b/source/images/faq/faq_no_unique_id.jpg new file mode 100644 index 0000000000000000000000000000000000000000..0acc7c0226f00a3cafba995c4f872252efeffc74 GIT binary patch literal 41156 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

D!DaOFx;e2Ab*cE_H~8O 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 R