From 595d0c81fb896484e3e89219ae5038256915723f Mon Sep 17 00:00:00 2001 From: DubhAd Date: Fri, 20 Oct 2017 07:07:34 +0100 Subject: [PATCH] Adding note on entity naming (#3677) Adding troubleshooting note about entity names. I wonder if this needs called out into its own section in the introductory documents though. --- source/_docs/configuration/troubleshooting.markdown | 10 ++++++++++ 1 file changed, 10 insertions(+) diff --git a/source/_docs/configuration/troubleshooting.markdown b/source/_docs/configuration/troubleshooting.markdown index f16cdb7ab85..f1b88fe876e 100644 --- a/source/_docs/configuration/troubleshooting.markdown +++ b/source/_docs/configuration/troubleshooting.markdown @@ -87,3 +87,13 @@ Contents of `sensors.yaml`:

Whenever you report an issue, be aware that we are volunteers who do not have access to every single device in the world nor unlimited time to fix every problem out there.

+ +### {% linkable_title Entity names %} + +The only characters valid in entity names are: + +* Lowercase letters +* Numbers +* Underscores + +If you create an entity with other characters then Home Assistant may not generate an error for that entity. However you will find that attempts to use that entity will generate errors (or possibly fail silently).