## Description Adjust device relative brightness. When brightness is set to any value greater than 0, if the device is off, it powers on, and the [`OnOffState.state`](https://developers.home.google.com/automations/schema/reference/entity/sht_device/on_off_state.md.txt) changes to reflect that the device is on. Likewise, when brightness is set to 0, the device powers off and the [`OnOffState.state`](https://developers.home.google.com/automations/schema/reference/entity/sht_device/on_off_state.md.txt) changes accordingly. ## Fields | Key | Type | Description | |---|---|---| | `devices` | \[[Device](https://developers.home.google.com/automations/schema/basics.md.txt#entity)\] | Devices such as lights that support changing brightness. Required | | `brightnessRelativePercent` | [Number](https://developers.home.google.com/automations/schema/basics.md.txt#number) | The exact percentage of brightness to change. Optional
To use this field, all the following fields CANNOT be used: *brightnessRelativeWeight*
| | `brightnessRelativeWeight` | [Number](https://developers.home.google.com/automations/schema/basics.md.txt#number) | This indicates the ambiguous amount of the brightness change. From small amount to large amount, this param will be scaled to integer 0 to 5, with the sign to indicate direction. Optional | ## Examples ```yaml actions: type: device.command.BrightnessRelative devices: My Device - Room Name brightnessRelativePercent: 50 ```