A custom integration for connected Sub-Zero refrigerators and freezers, Wolf ovens, and Cove dishwashers, installed through HACS.
Sign in with your Sub-Zero Group Owner email and password directly in Home Assistant. Appliances are monitored and controlled over Sub-Zero's cloud service using their existing Wi-Fi connections. Bluetooth is not required.
Requires Home Assistant 2026.8.0 or newer and an appliance already connected to your Sub-Zero account.
The Sub-Zero Group Owner's App is available in Canada, Mexico, and the United States. See Sub-Zero's country availability.
Use the button above, or add the repository manually:
- Open HACS → ⋮ → Custom repositories.
- Add
https://github.com/orienw/ha-subzerowith type Integration. - Download Sub-Zero, then restart Home Assistant.
- Open Settings → Devices & services → Add integration → Sub-Zero.
- Enter your Sub-Zero account email and password, then select the appliances to include.
To change the selection later, open Settings → Devices & services → Sub-Zero → Configure. This refreshes the account's appliance list using the saved connection. Deselecting an appliance removes its Home Assistant device and entities.
For manual installation, copy custom_components/subzero into your Home Assistant configuration's custom_components directory, restart, and follow steps 4–5.
Entities are created only for recognized properties that each appliance reports, at setup and as new properties appear in push updates. There is no model allowlist.
Temperature entities require the appliance to be set to Fahrenheit in the Sub-Zero app. Setpoints are sent as whole degrees Fahrenheit, and Home Assistant converts readings and inputs to your preferred display unit. Appliance units are read at startup and on reload, falling back to the last saved unit if the appliance list is temporarily unavailable. After changing the unit in the app, reload the integration. Appliances set to other units keep all of their non-temperature entities.
Timestamp sensors require an explicit timezone offset, either in the timestamp or in the appliance clock, and otherwise show as unknown.
Installing, restarting, or reconnecting the integration never changes appliance settings. Settings change only when you use a control or run an automation.
| Control | Settings |
|---|---|
| Temperature setpoints | Refrigerator, freezer, crisper |
| Crisper temperature mode | Automatic, Manual |
| Humidity control | Normal, Enhanced |
| Ice maker | Off, On, Max ice, Night ice |
| Mode | Normal, Sabbath, High use, Short vacation, Long vacation |
| Night mode | Disabled, Enabled |
| Air purification | On, Off |
| Accent light | 0–100%, optional control for glass-front models, disabled by default |
The Ice maker control shows the selected mode. In Night ice, the separate Ice maker enabled status may be Off while the schedule pauses ice production.
Select Manual crisper temperature mode to adjust its setpoint. In Automatic mode, the setpoint control is unavailable and the sensor continues to show the configured value. The manual range stays within 2°F of the refrigerator setpoint, between 34°F and 42°F. See Sub-Zero's crisper temperature guide.
Turn off Max ice before adjusting the freezer setpoint. Refrigerator and freezer zones also provide climate entities for thermostat cards, with the same temperature limits and Max ice interlock as the number controls.
Humidity control affects the refrigerator zone. Night mode dims the interior lights when the room is dark; Night ice is a separate ice-maker setting.
| Type | Available properties |
|---|---|
| Temperature setpoints | Refrigerator, freezer, crisper |
| Display temperatures | Refrigerator and freezer, on models that report them |
| Filters | Air and water filter life remaining, water filter capacity in gallons |
| Doors | Refrigerator and freezer door open |
| Ice-maker settings | Enabled, max ice, night ice, plus Max ice start and end times |
| Operating modes | Sabbath, high use, short vacation, long vacation, plus High use start and end times |
| Device status | Service required, power |
| Diagnostic | Wi-Fi signal strength |
Ice-maker settings and operating modes report their on/off state alongside their selectors. Switches report their own On/Off state, so they have no duplicate binary sensors.
Refrigerator temperatures on the primary tested model are configured setpoints. The integration does not infer a measured temperature from a setpoint. A negative water filter capacity indicates usage beyond the reported filter capacity.
Each reported oven cavity has its own entities. First-cavity entity IDs are preserved from earlier releases; a second cavity uses names prefixed with Lower oven.
| Type | Available properties |
|---|---|
| Temperatures | Measured oven and probe temperatures, oven and probe setpoints |
| Status | Door, cooking, preheated, remote ready, probe in use, probe target reached, Gourmet mode |
| Timers | Cooking timer active or complete, both kitchen timers active or complete, reported start/end times |
| Cooking mode | Recognized mode name and whether the appliance permits mode changes |
| Shared status | Sabbath mode, service required, Wi-Fi signal strength |
Controls include:
- A climate entity for each cavity, with temperature control and on/off actions. Temperature changes require the oven to be running or in Remote Ready. The overall range is 85–550°F; the appliance can impose narrower limits for its current mode.
- A cooking-mode selector and an interior-light switch for each cavity. Selecting Off turns that cavity off.
- A Start oven button for each cavity, available only when the oven reports Remote Ready and a supported cooking mode and temperature are configured.
- Two kitchen-timer duration controls, from 0 to 660 minutes. Setting a duration starts or restarts that timer; 0 cancels it. The number shows the configured duration when reported start/end times permit it. End-time sensors can drive countdown dashboards.
Enable Remote Ready at the oven before each remote start. Opening a door cancels it. Broil, Convection broil, Proof, Self clean, and Gourmet must be started at the appliance. Those restrictions also apply to automations. See Wolf's Remote Ready guide.
Oven temperature fields that report zero while idle show as unknown; probe readings also show as unknown when the probe is not in use. Unknown cooking-mode codes show as unknown and cannot be selected.
| Type | Features |
|---|---|
| Cycle monitoring | Wash cycle, wash status, cycle active, cycle end time |
| Status | Door, Remote Ready, rinse aid low, softener salt low, service required |
| Options | Heated dry, Extended dry, High temperature wash, Sanitize rinse, Top rack only |
| Delay start | Off or 1–12 hours, active status and reported start/end times |
| Start | Start wash cycle button, available when Remote Ready is enabled |
Select the wash cycle using the appliance or official app. To enable remote starting, hold ENTER on the dishwasher for five seconds, then close the door within four seconds. Opening the door cancels Remote Ready. See Cove's Remote Ready guide.
Unknown wash cycle/status codes show as unknown. The integration sends only supported option properties; the appliance enforces which options apply to its selected cycle.
Wi-Fi signal strength is enabled by default. Uptime, IP address, MAC address, and live reporting mode are diagnostic sensors disabled by default. Enable them from the entity settings when needed.
Download diagnostics from the integration or individual device page. Downloads use the cached appliance state and omit account credentials, appliance names, serial numbers, and network identifiers. They also list unrecognized state key names, without their values.
Integration diagnostics count appliance notifications received, ignored, or invalid since the last reload. Heartbeats are excluded from the received count. Each appliance also records parsed snapshots and updates, with the time of the last one. These counts help distinguish incoming messages from a connection that only receives heartbeats; they do not prove every state change was received or applied.
Enable debug logging for custom_components.subzero to record channel-open attempts, notification types and payload key names, and parsed state updates. State values exclude network identifiers and nested objects.
Sub-Zero CL4850UFDID is the primary tested appliance. Cloud status and push snapshots have also been tested with Wolf SO3050PMSP. The additional fridge features, oven controls, second-cavity support, and Cove entities are covered by automated tests using simulated appliance responses and have not yet been verified against physical appliances.
Other models can be added if the cloud service returns their status. Their entities depend on which recognized properties they report.
Local network access and accounts requiring additional verification or an external sign-in provider are not supported.
Selected appliances share account tokens and one cloud notification connection. Setup opens the push connection and waits up to 16 seconds for initial state, then requests any missing state. Healthy appliances trigger no periodic status requests. Lost connections reconnect with increasing delays, and rate-limit responses are honored.
After an error, a reopened channel or an incoming state update triggers a fresh status read if no full push snapshot has restored the appliance. Failed recovery reads retry with increasing delays. An appliance that silently stops reporting may go unnoticed until a notification or a failed control request reveals it.
Control changes are confirmed from appliance status, not from the command acknowledgement. If no push update arrives, the integration makes one status request to check the setting. Changing a mode sends only the settings that differ, one at a time, and stops if a change fails.
Sub-Zero does not document an API quota. Push updates keep requests low, but multiple appliances or unstable connections can still hit rate limits.
Your password is used for sign-in and is not saved. Home Assistant stores renewable account tokens in its configuration and refreshes them automatically. If renewal fails, Home Assistant asks you to sign in again. Protect Home Assistant backups as you would other account credentials.
This is an unofficial integration using the mobile application's cloud endpoints and application settings. Changes to Sub-Zero's login service, API, or shared application key can require an integration update. It is not affiliated with Sub-Zero Group.
Open an issue with your Home Assistant version, integration version, appliance model, and steps to reproduce the problem. Include whether the same operation works in the Sub-Zero app, plus any relevant custom_components.subzero log messages. Remove account details and tokens before posting logs.
Use Python 3.14:
python -m venv .venv
.venv/bin/pip install -r requirements-test.txt
.venv/bin/pytest
.venv/bin/ruff check .
.venv/bin/ruff format --check .