This blueprint allows you to configure actions for all 4 buttons on the original kinetic Philips Hue Tap Switch (model 8718696743133 / 9290011152X / ZGPSWITCH) paired via the official Philips Hue integration.
(Note: This is for the original 4-button kinetic switch without batteries, NOT the newer Hue Tap Dial).
Method 1: My Home Assistant (One-Click)
Click the badge below to open your Home Assistant instance and import automatically:
Method 2: Manual Import via URL
- In Home Assistant, navigate to Settings > Automations & Scenes > Blueprints.
- Click Import Blueprint (bottom right).
- Paste the following URL into the dialog:
https://github.com/epiech/ha-blueprints/blob/main/blueprints/automation/hue/philips_hue_tap.yaml
- Click Preview Blueprint, then click Import Blueprint.
Why this blueprint?
Previous Hue Tap blueprints stopped matching devices in recent Home Assistant versions because the model identifier in the Hue integration device registry changed from Hue tap switch (ZGPSWITCH) to Hue tap switch. This blueprint supports both legacy and modern device formats, includes trigger IDs, and supports initial press events.
Inputs
- Philips Hue Tap Switch: Select your paired Hue Tap device.
- Button 1: Large main button (1 dot)
- Button 2: Bottom left (2 dots)
- Button 3: Bottom center (3 dots)
- Button 4: Bottom right (4 dots)