Replace Device

A sensor died? Pair the new one – it takes over the old one's name, entity IDs and history. Your automations and dashboards keep working.

Feedback welcome. It has been tested on real moves between ZHA, Zigbee2MQTT, HomeKit and Matter, and checked against how Hue, Z-Wave JS and Shelly name their devices – but not yet on real Hue, Z-Wave or Shelly devices, and every home is different. If something doesn't move over as it should, please open an issue and say which integration you moved from and to. You can always fix names afterwards with Change.

English · Dansk

English

When a device breaks and you buy a new one, Home Assistant sees a stranger: new entity IDs, no history, and every automation, script and dashboard still points at the dead one. Replace Device moves everything over in one go – for one device, or for a whole network moving from ZHA to Zigbee2MQTT.

What moves over

Entity IDs	The new entities get the old IDs, so automations, scripts, scenes, dashboards and templates keep working.
History and statistics	Graphs and long-term statistics continue. Energy totals too – a new meter starting at 0 kWh is handled as a reset.
Your settings	Names, icons, areas, labels, categories, voice aliases, display precision and unit settings.
The device	The new device gets the old one's name and area – also in Zigbee2MQTT, if you want. If the old device stays (its integration won't let go, or you keep it), it's renamed "… (old – can be deleted)" so it's easy to spot.
Automations and scripts	Everything that points at the old device by ID in automations.yaml, scripts.yaml and scenes.yaml. Files in packages/ are your own, so they are never changed: Test first shows every line to change (before → after) for you to do by hand.
Entity IDs of new entities	Entities only the new device has (e.g. Zigbee2MQTT's extra sensors) get IDs after the device's name, like sensor.kitchen_sensor_linkquality instead of sensor.0x00158d…_linkquality. For replacements made before, use Edit → Tidy up entity IDs.
Button triggers	Triggers with other names in the new integration are translated (ZHA remote_button_short_press → Zigbee2MQTT action: single), and so are zha_event triggers and Zigbee2MQTT MQTT topics – also in wait_for_trigger and in scripts.yaml. In packages/ and YAML dashboards, which are your own files, it lists what to change by hand.
Blueprints	Inputs meant for the old integration are moved to the right ones – e.g. a "ZHA / Zigbee2MQTT" remote blueprint gets the Zigbee2MQTT name and base topic instead of the ZHA device.
Dashboards and other integrations	Dashboards made in the UI are updated. Other integrations that store the device (e.g. Battery Notes) are listed; helpers with a settings form can be ticked in Test first and are then changed through that form.
Zigbee groups	Make the group again in the new integration with the same name, and it takes over the old group's entity ID and history.

A note is added to the logbook, and if the new device sends no values after 10 minutes, you get a repair.

Before you replace: what could still bite

The preview lists what it can't fix by itself, so nothing comes as a surprise:

• Entities only the old device had, and where they are used
• Values the new one doesn't have (e.g. On vs on in a select)
• Unit changes – shown in red for energy, because Wh → kWh breaks the energy statistics
• Device actions of the old integration (e.g. a ZHA LED effect)
• Code outside Home Assistant (AppDaemon, Node-RED, pyscript …) that mentions the old device – only when it is found

It notices by itself

Pair a new device of the same make and model while an old one has been dead for an hour, and a repair shows up: "New Aqara WSDCGQ11LM found – replace Kitchen?". Tap Fix, check the preview, done.

Move many devices at once

Moving from ZHA to Zigbee2MQTT (or any integration to another)? Pair the devices in the new integration, then tap Move many devices in the panel and pick from and to. Every device found in both is paired by what doesn't change: the Zigbee address (IEEE), the serial number (Matter) or the MAC address (Wi-Fi). Names don't matter. Untick the ones to leave, and move them all with one tap.

Optional AI help

Connect any AI Task entity (e.g. Google Gemini, free) under Settings → Devices & services → Replace Device → Configure. It is only asked when something can't be matched by itself: entities named differently on the old and the new device ("Analog input" ↔ "Local temperature"), and button triggers with no obvious twin. Suggestions are marked AI in the panel, and you can change them. It is told what each device is (make, model, from and to which integration), and a move of many devices is one AI call, not one per device. If the AI can't answer (e.g. its daily quota is used up), the panel says so and the open items are marked to check. Tip: give it its own free Gemini key in its own project, so it doesn't share the daily quota.

Installation

1. Open HACS, search for Replace Device → Download, and restart Home Assistant.
2. Settings → Devices & services → Add integration → Replace Device → Submit.

Can't find it in the HACS search? Add it as a custom repository first: HACS → ⋮ → Custom repositories → https://github.com/Clahen86/ha-replace-device, type Integration → Add.

How to replace a device

1. Pair the new device as you normally would.
2. Open Replace device in the sidebar. Devices without contact are listed with a hint – the last battery level ("change the battery first") or "switched off at the wall?" – and a likely replacement when one is found: tap Replace with …. A bulb that is only switched off can be hidden. Or tap Replace a device, search for the old one, then the new one. The same physical device or the same model is shown first.
3. The old and the new device are shown side by side. Each old entity has its match picked (temperature to temperature, battery to battery) – also when the names are in different languages, by comparing the integration's own feature names. Several channels of the same kind (L1/L2, buttons 1–3) pair in order, even when the numbers differ between integrations. A close call is marked check. Change one if it's wrong, or pick "— removed".
4. Read what to check. Not sure? Tap Test first: it shows exactly what would happen – which entity IDs change, which automations, scripts and dashboards are updated, and how each button trigger is translated – without changing anything. It works for Move many devices too.

When entity IDs change by themselves

A cloud sync renames sensor.living_temp to sensor.living_temperature, or a device that was lost comes back as sensor.kitchen_temperature_2 – and your automations quietly stop working. Replace Device notices when an entity ID that something uses changes, and a repair offers two ways out:

• Use the new ID everywhere: automations, scripts, scenes, dashboards made in the UI and the energy dashboard are updated. Your own YAML files are listed line by line to change yourself.
• Give the entity its old ID back: so everything works as before.

Both can be undone in the list. Changes Replace Device makes itself, and IDs nothing uses, never give a repair.

Dead references

Dead references on the front page lists every entity ID that automations, scripts, scenes and dashboards still use, but that is gone – with the best replacement and how sure it is. Tap Move here to point every place at the replacement (with undo in the history), Remove the old one for a forgotten entity, or Ignore. Fix all sure ones only moves matches that are clearly the same thing – never two different lamps or people with similar names. Your own YAML files and code outside Home Assistant are listed line by line under See every place.

Rename a device

Home Assistant can rename a device and its entity IDs, but automations, scripts, dashboards and helpers keep pointing at the old IDs. Rename a device changes the name and the entity IDs, and updates the places the Home Assistant editors manage:

• automations, scripts and scenes (also inside templates and blueprint inputs)
• dashboards made in the UI and the energy dashboard
• the name in Zigbee2MQTT

The rest is your own files or other integrations' settings. Your own files are never changed: Test first shows every line to change (before → after) so you can do it by hand. Helpers with a settings form can be ticked, and are then changed through that form: helpers and other integrations that store the ID, packages/ and other YAML files that configuration.yaml includes, the voice assistant's custom_sentences/, ESPHome files, and code outside Home Assistant (Node-RED, AppDaemon).

History and statistics follow by themselves. Tap Test first to see every change before it happens, and Undo in the list puts it all back.

The list on the front page shows what still needs a look first (button triggers to check, entity IDs to tidy up). The rest is folded away under Done. 5. Tap Replace now.

Got two names mixed up (temperature and humidity, say)? Tap Change next to the replacement under Replaced and move the names to the right entities. Only names change – the device stays where it is.

The same is available without the panel: Settings → Devices & services → Replace Device → Replace a device.

Good to know

• The old device is removed, so its names are free – ZHA devices with ZHA's own remove, so ZHA doesn't add them again. If an integration doesn't allow it, you're told to remove it there. An old device that comes back anyway is shown under Left behind after a move, with a button to remove it, and is never paired again.
• Zigbee2MQTT only tells Home Assistant about a button press after it has been pressed once, so the full list of presses is read from Zigbee2MQTT itself. After a move, press each button once. A press that can't be matched for sure is listed for you to check – never guessed (button 1 never becomes button 2). Change → Check buttons again translates what is left.
• Reset or unpaired the old device first, so it lost its entities? Home Assistant still remembers their names for a while, and the new device takes those (marked "names remembered" in the list) – history included.
• Button presses can be called differently in another integration (single_press vs multi_press_1); you're told before you replace.
• Dead devices are found by being unavailable for an hour. In Zigbee2MQTT that needs availability turned on (Settings → Availability); without it, a dead device keeps its last value.
• If one step fails (a broken dashboard, a file it can't read), the rest still runs and the replacement can still be undone; the log says what was skipped.
• A replacement can't move a device back to its old integration – that takes pairing it there again (and then a new replacement the other way). Under Change you can give the new device its own names back, but the old device doesn't return and automations using the old names stop working, so you're warned first. Do again redoes it.
• Not moved: Zigbee bindings (a remote bound directly to a bulb) and calibration set in ZHA or Zigbee2MQTT. Code outside Home Assistant is only reported, not changed.
• Everything runs locally. Only with the AI help turned on are names and types of the entities and triggers sent to the AI you picked.
• Available in English, Danish, German, Swedish and Dutch – it follows your Home Assistant language. Better wording or a new language is very welcome as a pull request.

Dansk

Feedback er velkommen. Den er testet på rigtige flytninger mellem ZHA, Zigbee2MQTT, HomeKit og Matter og tjekket mod, hvordan Hue, Z-Wave JS og Shelly navngiver deres enheder. Den er endnu ikke prøvet på rigtige Hue-, Z-Wave- eller Shelly-enheder, og alle hjem er forskellige. Hvis noget ikke flyttes, som det skal, så opret et issue, og skriv hvilken integration du flyttede fra og til. Du kan altid rette navne bagefter med Ret.

Når en enhed går i stykker, og du køber en ny, ser Home Assistant en fremmed. Den får nye entity-id'er og ingen historik, og alle automatiseringer, scripts og dashboards peger stadig på den døde. Udskift enhed flytter det hele over i ét hug. Det virker for én enhed eller for et helt netværk, der flytter fra ZHA til Zigbee2MQTT.

Det flyttes over

• Entity-id'er: De nye entiteter får de gamle id'er, så automatiseringer, scripts, scener, dashboards og skabeloner virker videre.
• Historik og statistik: Grafer og langtidsstatistik fortsætter. Det gælder også energi. En ny måler, der starter på 0 kWh, bliver regnet som en nulstilling.
• Dine indstillinger: Navne, ikoner, områder, etiketter, kategorier, stemme-aliasser, antal decimaler og enheder.
• Enheden: Den nye enhed får den gamles navn og område, og hvis du vil, også i Zigbee2MQTT. Bliver den gamle enhed liggende (fordi integrationen ikke vil slippe den, eller fordi du beholder den), får den navnet "… (gammel – kan slettes)", så den er nem at finde.
• Automatiseringer og scripts: Alt, der peger på den gamle enhed via id, i automations.yaml, scripts.yaml og scenes.yaml. Filer i packages/ er dine egne. De bliver aldrig ændret: Test først viser hver linje, du skal rette (før → efter).
• Entity-id'er på nye entiteter: Entiteter, som kun den nye enhed har (fx Zigbee2MQTT's ekstra sensorer), får id'er efter enhedens navn, fx sensor.kokken_sensor_linkquality i stedet for sensor.0x00158d…_linkquality. Ved tidligere udskiftninger: Ret → Ryd op i entity-id'er.
• Knaptriggere: Triggere, der hedder noget andet i den nye integration, bliver oversat (ZHA remote_button_short_press → Zigbee2MQTT action: single). Det samme gælder zha_event-triggere og Zigbee2MQTT-MQTT-emner, også i wait_for_trigger og i scripts.yaml. I packages/ og YAML-dashboards, som er dine egne filer, viser den, hvad du selv skal rette.
• Blueprints: Felter til den gamle integration bliver flyttet til de rigtige. Fx får en "ZHA / Zigbee2MQTT"-fjernbetjeningsblueprint Zigbee2MQTT-navnet og base topic i stedet for ZHA-enheden.
• Dashboards og andre integrationer: Dashboards lavet i brugerfladen bliver rettet. Andre integrationer, der gemmer enheden (fx Battery Notes), bliver vist. Hjælpere med en indstillingsside kan du sætte flueben ved i Test først, og så bliver de rettet via den side.
• Zigbee-grupper: Lav gruppen igen i den nye integration med samme navn, så overtager den den gamle gruppes entity-id og historik.

Der kommer en note i logbogen. Sender den nye enhed ingen værdier efter 10 minutter, får du en reparation.

Før du udskifter: det, der stadig kan drille

Forhåndsvisningen viser det, den ikke selv kan rette, så intet kommer bag på dig:

• Entiteter, som kun den gamle enhed havde, og hvor de bruges
• Værdier, som den nye ikke har (fx On mod on i en select)
• Skift af enhed. Det vises med rødt for energi, fordi Wh → kWh ødelægger energistatistikken.
• Enhedshandlinger fra den gamle integration (fx en ZHA-LED-effekt)
• Kode uden for Home Assistant (AppDaemon, Node-RED, pyscript osv.), der nævner den gamle enhed. Det vises kun, hvis noget bliver fundet.

Den opdager det selv

Parrer du en ny enhed af samme mærke og model, mens en gammel har været død i en time, kommer der en reparation: "Ny Aqara WSDCGQ11LM fundet – skal den erstatte Køkken?". Tryk Ret, se forhåndsvisningen, og så er det klaret.

Flyt mange enheder på én gang

Skal du flytte fra ZHA til Zigbee2MQTT eller mellem to andre integrationer? Par først enhederne i den nye integration. Tryk så Flyt mange enheder i panelet, og vælg fra og til. Alle enheder, der findes begge steder, bliver parret på det, der ikke ændrer sig: Zigbee-adressen (IEEE), serienummeret (Matter) eller MAC-adressen (Wi-Fi). Navnene er ligegyldige. Fjern fluebenet ved dem, der skal blive, og flyt resten med ét tryk.

Valgfri AI-hjælp

Tilslut en AI Task-enhed, fx Google Gemini, som er gratis, under Indstillinger → Enheder og tjenester → Udskift enhed → Konfigurer. Den bliver kun spurgt, når noget ikke kan matches af sig selv. Det gælder entiteter med forskellige navne på den gamle og den nye enhed ("Analog input" ↔ "Local temperature") og knaptriggere uden en oplagt tvilling. Forslagene er markeret med AI i panelet, og du kan ændre dem. Den får at vide, hvad hver enhed er (mærke, model og fra hvilken integration til hvilken), og en flytning af mange enheder er ét AI-kald i stedet for ét pr. enhed. Kan AI'en ikke svare, fx fordi dagens kvote er brugt op, står det i panelet, og det, den skulle have hjulpet med, er markeret til at tjekke. Tip: Giv den sin egen gratis Gemini-nøgle i sit eget projekt, så den ikke deler dagskvoten med andet.

Installation

1. Åbn HACS, søg efter Replace Device → Download, og genstart Home Assistant.
2. Indstillinger → Enheder og tjenester → Tilføj integration → Udskift enhed → Send.

Kan du ikke finde den i HACS-søgningen? Tilføj den først som brugerdefineret repository: HACS → ⋮ → Brugerdefinerede repositories → https://github.com/Clahen86/ha-replace-device, type Integration → Tilføj.

Sådan udskifter du en enhed

1. Par den nye enhed, som du plejer.
2. Åbn Udskift enhed i sidemenuen. Her ser du enheder uden kontakt med et hint, fx det sidste batteriniveau ("skift batteriet først") eller "slukket på kontakten?". Har den fundet en sandsynlig afløser, står den der: Tryk Udskift med …. En pære, der bare er slukket, kan skjules. Du kan også trykke Udskift en enhed, søge den gamle frem og derefter den nye. Den samme fysiske enhed eller samme model står øverst.
3. Den gamle og den nye enhed vises side om side. For hver gammel entitet er den matchende valgt, fx temperatur til temperatur og batteri til batteri. Det virker også, når navnene er på forskellige sprog, fordi integrationernes egne navne for funktionerne sammenlignes. Flere kanaler af samme slags (L1/L2, knap 1–3) parres i rækkefølge, også når numrene er forskellige i de to integrationer. Et usikkert valg er markeret med tjek. Ret den, hvis den er forkert, eller vælg "— fjernes".
4. Læs, hvad du skal tjekke. I tvivl? Tryk Test først. Den viser præcis, hvad der ville ske: hvilke entity-id'er der skifter, hvilke automatiseringer, scripts og dashboards der opdateres, og hvordan hver knaptrigger oversættes. Intet bliver ændret. Det virker også ved Flyt mange enheder.

Når entity-id'er skifter af sig selv

En sky-synkronisering omdøber sensor.stue_temp til sensor.stue_temperature, eller en enhed, der var væk, kommer tilbage som sensor.kokken_temperatur_2 – og dine automatiseringer holder stille op med at virke. Udskift enhed opdager, når et entity-id, som noget bruger, skifter, og en reparation giver to muligheder:

• Brug det nye id alle steder: automatiseringer, scripts, scener, dashboards lavet i brugerfladen og energi-dashboardet bliver rettet. Dine egne YAML-filer bliver vist linje for linje, så du selv kan rette dem.
• Giv entiteten sit gamle id igen: så virker alt som før.

Begge dele kan fortrydes i listen. Ændringer, Udskift enhed selv laver, og id'er, som intet bruger, giver aldrig en reparation.

Døde referencer

Døde referencer på forsiden viser alle entity-id'er, som automationer, scripts, scener og dashboards stadig bruger, men som er væk – med den bedste afløser og hvor sikker den er. Tryk Flyt hertil for at rette alle steder (kan fortrydes i historikken), Slet den gamle for en glemt entitet, eller Ignorér. Ret alle sikre flytter kun dem, der tydeligt er det samme – aldrig to forskellige lamper eller personer med næsten samme navn. Dine egne YAML-filer og kode uden for Home Assistant vises linje for linje under Se alle steder.

Omdøb en enhed

Home Assistant kan omdøbe en enhed og dens entity-id'er, men automatiseringer, scripts, dashboards og hjælpere peger stadig på de gamle id'er. Omdøb en enhed skifter navnet og entity-id'erne og retter de steder, Home Assistants editorer styrer:

• automatiseringer, scripts og scener (også i skabeloner og blueprint-input)
• dashboards lavet i brugerfladen og energi-dashboardet
• navnet i Zigbee2MQTT

Resten er dine egne filer eller andre integrationers indstillinger. Dine egne filer bliver aldrig ændret: Test først viser hver linje, du skal rette (før → efter). Hjælpere med en indstillingsside kan du sætte flueben ved, og så bliver de rettet via den side: hjælpere og andre integrationer, der gemmer id'et, packages/ og andre YAML-filer, som configuration.yaml inkluderer, stemmeassistentens custom_sentences/, ESPHome-filer og kode uden for Home Assistant (Node-RED, AppDaemon).

Historik og statistik følger med af sig selv. Tryk Test først for at se alle ændringer, før de sker, og Fortryd i listen sætter det hele tilbage.

Listen på forsiden viser øverst, hvad der stadig kræver handling (knaptriggere, der skal tjekkes, entity-id'er, der kan ryddes op). Resten er foldet sammen under Færdige. 5. Tryk Udskift nu.

Har to navne byttet plads, fx temperatur og fugt? Tryk Ret ved udskiftningen under Udskiftet, og flyt navnene til de rigtige entiteter. Kun navnene ændres. Enheden bliver, hvor den er.

Det samme kan gøres uden panelet: Indstillinger → Enheder og tjenester → Udskift enhed → Udskift en enhed.

Godt at vide

• Den gamle enhed bliver fjernet, så dens navne bliver ledige. ZHA-enheder fjernes med ZHA's egen fjern, så ZHA ikke laver dem igen. Tillader en integration det ikke, får du besked om at fjerne den der. En gammel enhed, der alligevel kommer igen, vises under Rester efter flytning med en knap til at fjerne den, og den bliver aldrig parret igen.
• Zigbee2MQTT fortæller først Home Assistant om et knaptryk, når knappen er trykket én gang. Derfor læses den fulde liste af tryk fra Zigbee2MQTT selv. Tryk på hver knap én gang efter en flytning. Et tryk, der ikke kan matches sikkert, vises, så du kan tjekke det. Det bliver aldrig gættet, så knap 1 bliver aldrig til knap 2. Ret → Tjek knapper igen oversætter det, der er tilbage.
• Har du nulstillet eller fjernet den gamle enhed først, så den mistede sine entiteter? Home Assistant husker deres navne et stykke tid, og den nye enhed overtager dem (markeret "navne huskes" i listen), inklusive historikken.
• Knaptryk kan hedde noget andet i en anden integration (single_press mod multi_press_1). Det får du at vide, før du udskifter.
• Døde enheder findes ved, at de har været utilgængelige i en time. I Zigbee2MQTT kræver det, at availability er slået til (Settings → Availability). Uden den beholder en død enhed sin sidste værdi.
• Fejler ét trin, fx et ødelagt dashboard eller en fil den ikke kan læse, kører resten alligevel, og udskiftningen kan stadig fortrydes. Loggen viser, hvad der blev sprunget over.
• En udskiftning kan ikke flytte en enhed tilbage til dens gamle integration. Det kræver, at den parres der igen, og derefter en ny udskiftning den anden vej. Under Ret kan du give den nye enhed dens egne navne tilbage, men den gamle enhed kommer ikke igen, og automatiseringer med de gamle navne holder op med at virke. Derfor bliver du advaret først. Gentag laver det igen.
• Det flyttes ikke: Zigbee-bindinger (en fjernbetjening bundet direkte til en pære) og kalibrering sat i ZHA eller Zigbee2MQTT. Kode uden for Home Assistant bliver kun vist, ikke ændret.
• Alt kører lokalt. Kun hvis AI-hjælpen er slået til, sendes navne og typer på entiteter og triggere til den AI, du har valgt.
• Findes på engelsk, dansk, tysk, svensk og hollandsk og følger sproget i din Home Assistant.

License

MIT