Compatibility update / September 19, 2026

Home Assistant 2026.9.3 restores Shelly 2PM Gen4 cover control

Home Assistant Core 2026.9.3 now creates lift-only controls for a calibrated Shelly 2PM Gen4 when slat tilt is disabled.

Home AssistantShellyMatter
By Matterhome Editorial Team/Editorial lead JC Martinez/
Shelly 2PM Gen4 relay with grey terminals and the Gen4 label
Official Shelly product image reused from Matterhome's 2PM Gen4 guide. Matterhome has not tested the Home Assistant fix.

Home Assistant Core 2026.9.3, released on September 18, 2026, restores cover control for a specific Shelly 2PM Gen4 setup. When the relay was configured as a blind controller with slat tilt disabled, Home Assistant's Matter integration could recognize the device but create no cover entity. An affected device page could show firmware information without the open, close and position controls.

The 2PM Gen4 declared a Matter tilt-position attribute but returned a null value when tilt was disabled for an ordinary roller shutter. Home Assistant treated that null attribute as a mismatch during entity discovery, so the device failed both the tilt-capable and lift-only cover paths.

The merged fix makes the tilt-position attribute optional and checks the device's Matter feature map and accepted commands before adding tilt controls. The pull request records manual verification with a calibrated 2PM Gen4 in both configurations: tilt disabled now produces a working lift-only entity, while tilt enabled still provides lift and slat controls.

Update Home Assistant before touching the relay

If a Matter-connected 2PM Gen4 in cover mode is missing its cover entity, update Home Assistant Core to 2026.9.3 or later and let the normal update restart complete. Then open the device page and check for the cover control. This patch changes Home Assistant's discovery logic, not Shelly firmware, so a factory reset or Matter recommissioning should not be the first response.

The fix has a clear limit. Home Assistant's verification says an uncalibrated 2PM Gen4 with tilt disabled still does not create a cover entity. Confirm that the relay is using its cover profile and has been calibrated before treating a remaining absence as the same bug. A unit running the switch profile is also outside this cover-specific path.

Home Assistant's release note refers broadly to Shelly devices, but the code review and real-device check name the 2PM Gen4. Matterhome has not tested other Shelly cover controllers against this patch. Owners using Shelly's native Home Assistant integration or the relay's alternative Zigbee mode are on different connection paths and should not expect this Matter-discovery change to alter those setups.

Content feedback

Spot a mistake or missing context?

Send a quick note so it can be checked against the source material.

Report content issue