| name | ha-translations-and-ids |
| description | Home Assistant translation_key and identifier practices—entity/device naming via translations, stable unique IDs, and migration tips. |
| license | Complete terms in LICENSE.txt |
HA Translations & IDs
Use when fixing names/IDs in a custom component.
Quick start
- Set
_attr_translation_key and _attr_has_entity_name=True; keep code names minimal.
- Provide names under
entity.<platform>.<translation_key>.name in translations JSON.
- Keep unique_ids stable; prefer device serial/model over mutable unit_id.
- Device identifiers should not change across reloads; plan migrations if format changes.
References