No need to panic over the “MQTT device name equals entity name” alert

Disclosure: This post contains affiliate links. If you click through and make a purchase, I will earn a commission, at no additional cost to you. Read my full disclosure here.

A generated image showing colourfull flowers.

As a Zigbee2MQTT user, you might have come across a rather puzzling error message after updating your Home Assistant to version 2023.8. The error, in essence, tells you that your “MQTT device name is equal to entity name in your config”. Sure, it sounds a bit like techno-jargon, but it's nothing to lose sleep over. The good news? This error is perfectly safe to ignore and will vanish with the next Zigbee2MQTT update, set to roll out sometime in the coming month.

Is my Zigbee2MQTT and Home Assistant configuration at risk?

In even better news, your setup isn't in a pickle. All your automations and scripts will keep ticking along just like they did in Home Assistant 2023.7. When Zigbee2MQTT's updated version hits the virtual shelves, you won't have to fiddle around with names or make any changes to the configuration of either application.

The root of the “MQTT device name” error

The “MQTT device name equals entity name” error took centre stage with the release of Home Assistant 2023.8. The culprit? A naming update for MQTT devices that introduced the has_entity_name property.

To break it down, this means Home Assistant will merge the device name (say, Office Desk Switch) and the entity name (like, Office Desk Switch Energy) to create a friendly name. Ideally, Zigbee2MQTT should only report the entity name as “Energy” to Home Assistant, and not as “Office Desk Switch Energy”. As an entity of the “Office Desk Switch”, Home Assistant should then automatically rename it to “Office Desk Switch Energy”. Currently, however, it's being instructed to call it “Office Desk Switch Office Desk Switch Energy”, which is a bit like calling a spade a spade a spade. It's a mouthful, isn't it?

Frequently asked questions

Yes, the error will disappear in Zigbee2MQTTs September 2023 release. There is no need for you to change anything in your configuration.
A portrait photo oif Liam Alexander Colman, the author, creator, and owner of Home Assistant Guide wearing a suit.

About Liam Alexander Colman

is an experienced Home Assistant user who has been utilizing the platform for a variety of projects over an extended period. His journey began with a Raspberry Pi, which quickly grew to three Raspberry Pis and eventually a full-fledged server. Liam's current operating system of choice is Unraid, with Home Assistant comfortably running in a Docker container.
With a deep understanding of the intricacies of Home Assistant, Liam has an impressive setup, consisting of various Zigbee devices, and seamless integrations with existing products such as his Android TV box. For those interested in learning more about Liam's experience with Home Assistant, he shares his insights on how he first started using the platform and his subsequent journey.

Leave a comment

Share to...