Skip to content

Breaking Changes

figorr edited this page Sep 14, 2025 · 5 revisions

⚠️ Breaking changes - Upgrade to 3.x or later coming from prior versions

Version 3.0.0 and later introduces a breaking change in how entities are identified.

⚠️ What this affects

  • This affects any update from a version prior to 3.0.0 to any version 3.x or later.
  • This change may affect existing dashboards, automations, and scripts.

What changed

  • Entities now use town_id instead of region_id in their unique_id.
  • This change allows multiple integration entries that share the same region_id but different towns.

✅ Recommended upgrade procedure

To avoid issues with duplicated or unavailable entities:

  1. Uninstall the existing integration (v2.x).
  2. Restart Home Assistant.
  3. Install v3.0.0 and configure the integration again.

🚨 If you update directly

If you update without uninstalling first:

  • Old entities will remain as Unavailable.
  • New entities will be created (sometimes with a suffix like 2).
  • You may need to manually remove old entities and update your automations, dashboards, or scripts to point to the new entities.

Additional notes

  • This change affects all entity types, including sensors, diagnostic sensors, and alerts.
  • Always backup your Home Assistant configuration before performing major upgrades.

⬅️ Home | ➡️ Installation

Clone this wiki locally