# Ha Translations And Ids

> Home Assistant translation_key and identifier practices—entity/device naming via translations, stable unique IDs, and migration tips. Use when this capability is needed.

- Skill: `tomevault-io/ha-translations-and-ids` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/ha-translations-and-ids`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/ha-translations-and-ids/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Integrations & APIs
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/ha-translations-and-ids

---


# 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
- [references/translations-json.md](references/translations-json.md)
- [references/ids-and-migrations.md](references/ids-and-migrations.md)

---
> Converted and distributed by [TomeVault](https://tomevault.io/claim/plebann) — claim your Tome and manage your conversions.
<!-- tomevault:4.0:skill_md:2026-04-13 -->