Les nommages dans Home Assistant, suite à vos retours

Cet article est une traduction de l'article du blog Home Assistant "Naming things in Home Assistant, shaped by your feedback" paru en novembre 2026.
La gestion des nommages dans Home Assistant est une évolution importante et nous vous incitons à lire cet article.

Naming things in Home Assistant, shaped by your feedback

We’re making naming in Home Assistant simpler. Your entity IDs and automations will keep working – find out what’s changing, why, and what to check.

Home AssistantArtur Pragacz

Juste avant la version 2026.4, nous avons retiré une modification concernant la dénomination des entités dans Home Assistant. Vous l’aviez testée en version bêta, vous nous aviez fait part de vos critiques, et nous vous avons écoutés. Cela nous a pris quelques mois supplémentaires, mais nous pensons que le résultat est désormais plus satisfaisant.

Nous avons comblé les lacunes que vous avez relevées, notamment les écrans qui ne fournissaient pas suffisamment de contexte. Nous avons également ajouté des « appareils enfants », qui attribuent à chaque partie d'un appareil – à l'instar des prises d'une multiprise – un nom et une zone qui lui sont propres.

Et surtout, vos identifiants d'entité, vos automatisations, vos scripts, vos scènes et vos tableaux de bord continueront de fonctionner.

Ce qui va changer à partir de la version 2026.11, disponible dès demain, c'est que la dénomination dans Home Assistant sera plus simple : vous nommerez chaque appareil et chaque entité en fonction de ce qu'ils sont réellement, et Home Assistant ajoutera le contexte correspondant.

C'est sans doute sur vos tableaux de bord et autres écrans que vous le remarquerez en premier. Chaque nom sera constitué de ses différents éléments, tels que la zone, l'appareil et le nom de l'entité, ce qui signifie que certains noms comporteront davantage d'informations contextuelles qu'auparavant.

Nous savons que beaucoup d'entre vous passent des heures à peaufiner la formulation de vos noms. La plupart s'afficheront comme prévu. D'autres, en revanche, auront un aspect différent : notamment les noms d'entités qui ne commencent pas actuellement par le nom de leur appareil. Nous vous expliquons ci-dessous pourquoi il en est ainsi et comment y remédier rapidement.

Mais avant de poursuivre, il y a une chose qui nous a souvent été signalée pendant la phase bêta : la terminologie utilisée pour les noms prêtait à confusion. Nom de l'appareil, nom de l'entité, nom convivial, identifiant de l'entité : quelle est la différence ? Voici un petit guide.

Qu'y a-t-il dans un nom ?

Imaginons qu'une prise connectée alimente votre machine à café et se trouve dans votre cuisine.

• Pièce : la pièce ou l'espace dans lequel se trouve la prise connectée. Cuisine.
• Appareil : l'objet physique. Prise connectée 3, ou le nom que vous lui donnez, par exemple Machine à café.
• Entité : une action qu'un appareil peut effectuer ou une valeur qu'il peut mesurer. La prise connectée comporte trois entités : un interrupteur, un capteur de puissance et un capteur d'énergie.

Chaque entité possède son propre nom, son identifiant et son nom descriptif. Ainsi, pour le capteur de puissance de la prise connectée :

• Nom de l'entité : le nom de cette objet.
• ID d'entité : l'identifiant fixe utilisé par vos automatisations. sensor.kitchen_smart_plug_3_power.
• Nom descriptif : attribut d'état qui combine le nom de l'appareil et celui de l'entité. Les anciennes cartes et les anciens modèles l'utilisent encore, mais nous sommes en train de l'abandonner. Prise connectée 3 Power.

D'où viennent les noms ?

Comment en sommes-nous arrivés à avoir autant de noms ? Tout a commencé tout simplement…

À ses débuts, Home Assistant ne reconnaissait que les entités. Il n’y avait ni appareils, ni zones, ni étages ; le nom d’une entité devait donc refléter tout son contexte. Pour distinguer les capteurs de consommation électrique les uns des autres, il fallait par exemple nommer l’un d’entre eux « Consommation de la machine à café de la cuisine ». La communauté a rédigé des guides complets sur les stratégies de nommage afin d’assurer la cohérence des noms.

À partir de 2018, Home Assistant a commencé à mettre en place une structure autour des entités. Les entités appartenant à un même objet physique ont été regroupées sous le nom de « périphérique ». Des zones, des étages et des étiquettes ont été ajoutés pour décrire l'agencement de votre logement. Mais cette structure a également entraîné des répétitions : ainsi, si vous déplaciez la machine à café dans une autre pièce, tous les noms de ses entités devenaient erronés.

Pour remédier à cela, les intégrations ont commencé à nommer chaque entité individuellement, sans mentionner le nom de l'appareil. Une intégration désignait une entité par sa nature, par exemple « Alimentation », et Home Assistant ajoutait le nom de l'appareil devant pour afficher « Prise intelligente 3 Alimentation ».

Il restait toutefois un problème : le fait de renommer une entité entraînait la suppression du nom de l'appareil correspondant. Si vous renommiez le commutateur d'une prise connectée « Machine à café », les autres entités de l'appareil pouvaient continuer à s'afficher sous les noms « Prise connectée 3 Alimentation » et « Prise connectée 3 Énergie ». Par conséquent, beaucoup d'entre vous devaient renommer chaque entité manuellement pour garantir la cohérence.

En bref :

Chacune de ces étapes semblait logique à l'époque, mais, prises dans leur ensemble, elles nous ont laissé des règles qui n'étaient pas toujours cohérentes entre elles. Cela fait plusieurs années que nous nous efforçons de démêler tout cela, et cette version marque une nouvelle étape dans ce processus.

Où allons-nous ?

Désormais, un ensemble de règles cohérent s'applique partout dans Home Assistant, du tableau de bord aux pages de paramètres. Vous nommez chaque objet une seule fois, en fonction de ce qu'il est : votre étage s'appelle « Rez-de-chaussée », votre pièce « Cuisine », votre appareil « Machine à café » et ses entités « Alimentation » et « Énergie ». Aucun nom ne se répète.

Home Assistant affichera alors le contexte selon les besoins :

• Sur la page dédiée à la cuisine, la catégorie est déjà précisée ; l'appareil apparaît donc simplement sous le nom « Machine à café », et non « Machine à café de cuisine ».
• Sur la page dédiée à la machine à café, l'en-tête indique déjà le nom de l'appareil et sa zone ; les entités sont donc simplement répertoriées sous les noms « Alimentation » et « Énergie ».
• Dans un sélecteur d'entités qui répertorie tous les capteurs de consommation de la maison, chaque ligne indique également l'appareil et la pièce correspondants, ce qui vous permet de les distinguer.
• Sur une fiche du tableau de bord, vous choisissez les éléments à afficher : entité, appareil, appareil parent, zone ou étage, dans l'ordre de votre choix.

Certaines entités n’ont pas besoin d’un nom propre. C’est l’interrupteur de la prise qui permet d’allumer et d’éteindre la machine à café ; il s’affichera donc uniquement avec le nom de l’appareil : « Machine à café ». Nous appelons cela « l’entité principale de l’appareil », et vous pourrez activer cette option pour n’importe quelle entité à l’aide de l’interrupteur « Entité principale de l’appareil » dans ses paramètres. C’est pourquoi renommer l’appareil, plutôt que l’interrupteur, permet à la plupart des utilisateurs d’obtenir le résultat souhaité.

Un appareil composé de plusieurs éléments disposera désormais d’un appareil enfant distinct pour chacun d’entre eux. Par exemple, une multiprise à quatre prises devient un appareil comprenant quatre appareils enfants, un pour chaque prise. Chaque prise peut avoir son propre nom, tel que « Bouilloire », et sa propre zone, au lieu d’entités appelées « Prise 3 », etc. Placez une prise dans une autre zone, par exemple une lampe dans la salle à manger, et elle s’affichera simplement sous le nom de « Lampe » à cet endroit, sans le nom de la multiprise.

Notre objectif est que vous n’ayez plus besoin d’un système de nommage pour maintenir l’ordre. Les noms par défaut devraient être corrects, et si vous souhaitez renommer un élément, vous n’aurez à le faire qu’une seule fois, à un seul endroit, car aucun nom ne contient de copie d’un autre. Vous pouvez toujours nommer les éléments comme bon vous semble. Si une zone n’est pas suffisamment précise, par exemple parce que vous avez deux spots dans une même cuisine, vous pouvez préciser ce détail dans le nom de l’appareil : « Spot de placard » et « Spot de plan de travail ».

Les nouveaux identifiants d'entité sont également constitués de ces éléments : depuis la version 2026.8, ils incluent la zone, et si vous le souhaitez, vous pouvez choisir quels éléments y figureront. Ainsi, deux appareils « TV » situés dans des pièces différentes se voient attribuer des identifiants distincts, sans le _2.

Ce que cela signifie pour vous

À partir de la version 2026.11, cette modification se traduira principalement de quatre façons.

Les tableaux de bord affichent les nouveaux noms

Les cartes, les badges et les lignes dont le nom n’a pas été défini manuellement afficheront le nouveau nom d’entité par défaut accompagné de son contexte, au lieu du nom convivial. Lorsque vous attribuez un nom à une carte, le sélecteur de nom vous permet de choisir les éléments que vous souhaitez. Vous pouvez à tout moment revenir à la valeur par défaut en un seul clic. Les noms que vous avez déjà définis sur une carte restent exactement tels quels. Le reste de Home Assistant suit les mêmes règles : les pages de paramètres, le journal d’activité, les descriptions d’automatisations, les paramètres de l’assistant vocal, les pages d’outils et la carte, ainsi que les applications Home Assistant pour Android et iOS.

Le fait de renommer une entité ne fait que donner un nom à l'entité

Lorsque vous renommez une entité, il vous suffit d’indiquer un nom pour la partie « entité », par exemple « Consommation électrique », sans rien ajouter d’autre. Home Assistant conservera ce nom tel que vous l’avez saisi et ajoutera le contexte (comme le nom de l’appareil ou de la zone) là où cela est nécessaire. Si ce que vous souhaitez réellement modifier, c’est le nom de l’appareil, vous devrez alors renommer l’appareil lui-même.

Les appareils complexes sont divisés en appareils enfants

À partir de cette version, Z-Wave, MQTT et ESPHome prendront en charge les appareils enfants décrits ci-dessus, tout comme certains appareils Tuya et quelques autres intégrations. La prise en charge de Matter et de ZHA est en cours, et d’autres intégrations suivront. Par conséquent, l’appareil parent d’origine sera conservé, mais ses éléments structurels – comme les différentes prises d’une multiprise – seront divisés en appareils enfants organisés séparément les uns des autres.

Le nom descriptif est en voie de disparition

De nombreuses cartes et modèles personnalisés utilisent encore le « nom convivial ». Nous allons le conserver pour l'instant à des fins de compatibilité ascendante, mais nous prévoyons de le déprécier, puis de le supprimer à terme. Nous annoncerons toute suppression à l'avance, afin que les auteurs de cartes et les utilisateurs de modèles puissent procéder à la mise à jour en premier lieu.

Choses à vérifier après la mise à jour 2026-11

À quoi s'attendre après la mise à jour, et quelques points auxquels il faudra peut-être prêter attention.

Les identifiants d'entité, les automatisations et les tableaux de bord continueront de fonctionner

Les identifiants des entités existantes ne changeront pas. Les automatisations, les scripts, les scènes et les tableaux de bord font référence aux entités par leur identifiant ; ils continueront donc à identifier la bonne entité. Seuls les noms affichés sont susceptibles de changer, comme décrit ci-dessous.

Vos noms existants seront transférés

Lors de la mise à jour, Home Assistant transférera les noms des entités que vous avez renommées par le passé. Comme nous l'avons mentionné au début, la plupart devraient s'afficher comme prévu, mais certaines pourraient apparaître différemment. Cela dépend de la façon dont le nom commence :

1. Si le nom d'une entité commence déjà par le nom de l'appareil correspondant, comme « Consommation électrique de la machine à café » pour une machine à café, la partie relative à l'appareil sera supprimée : l'entité s'appellera alors « Consommation électrique » et s'affichera sous la forme « Consommation électrique de la machine à café », comme auparavant.
2. Si le nom ne commence pas déjà par celui de l'appareil, rien ne change, sauf que Home Assistant ajoutera le contexte approprié là où c'est nécessaire : ainsi, un interrupteur que vous avez renommé « Machine à café » sur l'appareil « Prise intelligente 3 » s'affichera sous le nom « Prise intelligente 3 Machine à café ».

Si ce deuxième cas vous semble étrange, il est facile d’y remédier. Renommez l’appareil (dans ce cas, la prise connectée) en « Machine à café » et activez l’option « Entité principale de l’appareil » pour l’interrupteur. Il s’affichera alors simplement sous le nom « Machine à café » partout. Si vous avez le temps, c’est peut-être aussi le bon moment pour supprimer les noms de zones de vos noms d’entités et d’appareils. Home Assistant affichera le contenu approprié là où il le faut.

Pour les entités que vous rendez accessibles à Assist, Alexa ou Google Assistant, l'ancien nom sera également ajouté en tant qu'alias, afin que les commandes vocales continuent de fonctionner.

Notre documentation sur la dénomination explique plus en détail comment fonctionne la dénomination et ce que vous pourriez souhaiter renommer.

Certaines cartes personnalisées peuvent afficher des noms différents

Les fiches intégrées vous permettent de composer le nom à partir de différents éléments : faites glisser les éléments « entité », « appareil », « appareil parent », « zone » et « étage » dans l'ordre de votre choix, ou saisissez votre propre nom personnalisé. Certaines fiches personnalisées peuvent toutefois continuer à afficher le nom descriptif ; elles peuvent donc présenter un nom différent de celui des fiches intégrées, et ce nom changera dès que vous renommez l'entité ou son appareil. Modifiez le nom sur la fiche pour le corriger, ou mettez à jour la fiche dès que son auteur prendra en charge la nouvelle nomenclature.

Les modèles utilisant des noms descriptifs devront peut-être être modifiés

Si vos modèles utilisent encore des noms descriptifs, par exemple pour afficher les noms d'entités dans les notifications, ces noms peuvent différer de ceux affichés par Home Assistant et changer dès que vous renommez l'entité ou son appareil. Pour ne retenir que les éléments dont vous avez besoin, utilisez plutôt les fonctions entity_name(), device_name() et area_name().

Et maintenant ?

Nous savons que la dénomination est une question personnelle, et ce changement concerne toutes les installations – même si, pour de nombreux utilisateurs, il passera inaperçu. Il ne sera pas idéal pour toutes les configurations, mais nous sommes convaincus qu’il s’agit d’une amélioration. Au fil des prochaines versions, nous continuerons à transférer davantage d’intégrations vers les appareils enfants et à aider les auteurs de cartes personnalisées à adopter la nouvelle nomenclature.