Skip to content

Breaking Changes

figorr edited this page Sep 11, 2025 · 5 revisions

⚠️ Breaking Changes in Meteocat v3.x

Version 3.0.0 introduces a breaking change in how entities are identified.
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