Skip to content

Commit 6c29010

Browse files
authored
Add blog post for config_entry unique_id collision warning (#2467)
* Add blog post for config_entry unique_id collision warning * Update and rename 2024-11-22-config-flow-unique-id to 2024-11-22-config-flow-unique-id.md * Update 2024-11-22-config-flow-unique-id.md * Rename 2024-11-22-config-flow-unique-id.md to 2024-12-19-config-flow-unique-id.md * Adjust date * Rename 2025-01-16-config-flow-unique-id.md to 2025-03-01-config-flow-unique-id.md
1 parent 8e2c3c4 commit 6c29010

File tree

1 file changed

+15
-0
lines changed

1 file changed

+15
-0
lines changed
Lines changed: 15 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,15 @@
1+
---
2+
author: epenet
3+
authorURL: https://github.com/epenet
4+
title: "New checks for config flow unique ID"
5+
---
6+
7+
### Summary of changes
8+
9+
When a config flow creates an entry with a colliding unique ID, the old entry is currently automatically removed and replaced with the new config entry.
10+
This can lead to unexpected behavior, and integrations should be adjusted to instead abort the flow.
11+
12+
In case of manual flows, integrations should implement options, reauth, reconfigure to allow the user to change settings.
13+
In case of non user visible flows, the integration should optionally update the existing entry before aborting.
14+
15+
More details can be found in the [config flow](/docs/config_entries_config_flow_handler#unique-id-requirements) documentation.

0 commit comments

Comments
 (0)