2026.4.3
Home ▸ Integrations

Philips Hue

The Philips Hue integrationIntegrations connect and integrate Home Assistant with your devices, services, and more. [Learn more] allows you to control and monitor the lights and sensors connected to your Hue bridge. The integration supports:

  • Lights
  • Motion sensors (including temperature and light level sensors)
  • Remotes and switches (as device triggers for automations, and also exposed as battery sensors when they are battery-powered)

Configuration

To add the Philips Hue hub to your Home Assistant instance, use this My button:

Philips Hue can be auto-discovered by Home Assistant. If an instance was found, it will be shown as Discovered. You can then set it up right away.

Manual configuration steps

If it wasn’t discovered automatically, don’t worry! You can set up a manual integration entry:

  • Browse to your Home Assistant instance.

  • Go to Settings > Devices & services.

  • In the bottom right corner, select the Add Integration button.

  • From the list, select Philips Hue.

  • Follow the instructions on screen to complete the setup.

Lights for Hue zones and rooms

The Hue concept is based on Rooms and Zones. Although the underlying Hue lights are exposed directly to Home Assistant, it might also be useful to interact with the grouped lights of the Hue ecosystem, for example, to turn all lights in a Hue group on/off at the same time.

Home Assistant creates lights for each Hue zone and room automatically but disables them by default. To enable them, go to Settings > Devices & services, select the Philips Hue integration, and enable the grouped light entities you want to use.

Scenes

You can create, edit, and delete Hue scenes from the official Hue app on iOS and Android. Each room and zone can have its own scenes, and there is a large library of preset scenes for specific moods. These Hue scenes are automatically imported into Home Assistant and available as scene entities. Creating or editing Hue scenes in Home Assistant is not supported.

Using Hue scenes is recommended when you want to control multiple lights at once. If you control multiple lights individually or use Home Assistant scenes, each command is sent to each light one by one. A Hue scene sends commands to all lights at once in an optimized way, resulting in a smoother experience.

Action: Activate scene

The hue.activate_scene action lets you activate a Hue scene and set properties like dynamic mode or brightness at the same time.

  • Data attribute: entity_id

    • Description: The entity ID of the Hue scene to activate.
    • Required: Yes

  • Data attribute: transition

    • Description: Transition duration in seconds to bring devices to the state defined in the scene.
    • Required: No

  • Data attribute: dynamic

    • Description: Enable (true) or disable (false) dynamic mode for the scene.
    • Required: No

  • Data attribute: speed

    • Description: The speed of the dynamic palette for this scene.
    • Required: No

  • Data attribute: brightness

    • Description: The brightness for this scene.
    • Required: No

You can use this action, for example, to start or stop dynamic mode on a scene.

Configuration options

After setting up the integration, the following options can be configured by going to Settings > Devices & services, selecting the Philips Hue integration, and selecting Configure.

V2 bridges (square shape)

Ignore connectivity status for the given devices

Select devices for which the connectivity (availability) status should be ignored. This is useful for battery-powered devices like remotes that are reported as unavailable when they go to sleep.

V1 bridges (round shape)

Allow Hue groups

When enabled, creates light entities for Hue rooms.

Allow unreachable bulbs to report their state correctly

When enabled, allows bulbs that are reported as unreachable by the bridge to still report their last known state.

Hue remotes and switches

Hue remotes such as the Dimmer Switch are stateless devices, meaning that they do not have an on/off state like regular entities in Home Assistant. Instead, these devices emit the event hue_event when a button is pressed. You can test what events come in by going to Settings > Developer tools > Events and subscribing to hue_event. Once you know what the event data looks like, you can use it to create automations.

Note

The Hue API limits each device to one event per second. This means that button events are rate-limited to one per second.

Support for legacy (V1) Hue bridges

Signify released a newer version of the Hue bridge (square shape), and the legacy V1 bridge (round shape) is now end of life and no longer supported by Signify. Home Assistant will continue to support the V1 Hue bridge as long as it is technically possible, with the following limitations:

  • Scene entities are not automatically created for V1 bridges. To activate a Hue scene on a V1 bridge from Home Assistant, use the action described below.
  • State updates for devices on V1 bridges are not received instantly but polled on an interval.
  • Light entities for Hue rooms are not automatically created for V1 bridges. You can opt in to creating room entities in the integration’s options.

To activate a scene on a V1 bridge:

  1. Go to Scripts and select Add New Script > Add Action > Philips Hue: Activate Scene.
  2. Select the room name in the Group field and the scene name in the Scene field.

Data updates

V2 Hue bridges (square shape) push state changes to Home Assistant instantly over their local event stream. V1 Hue bridges (round shape) are polled on an interval because the V1 API does not support push updates.

Removing the integration

This integration follows standard integration removal. No extra steps are required.

To remove an integration instance from Home Assistant

  1. Go to Settings > Devices & services and select the integration card.
  2. From the list of devices, select the integration instance you want to remove.
  3. Next to the entry, select the three dots menu. Then, select Delete.