## Description Dispense items. ## Fields | Key | Type | Description | |---|---|---| | `devices` | \[[Device](https://developers.home.google.com/automations/schema/basics.md.txt#entity)\] | Devices that support dispensing a specified amount of one or more physical items. Required | | `item` | [String](https://developers.home.google.com/automations/schema/basics.md.txt#string) | Name of the item to dispense. Optional
To use this field, all the following fields CANNOT be used: *presetName* To use this field, all the following fields SHOULD be used: *amount* , *unit*
The available values depends on each device. | | `amount` | [Number](https://developers.home.google.com/automations/schema/basics.md.txt#number) | Amount to dispense Optional
To use this field, all the following fields CANNOT be used: *presetName* To use this field, all the following fields SHOULD be used: *unit* , *item*
| | `unit` | [String](https://developers.home.google.com/automations/schema/basics.md.txt#string) | Unit for the `amount`. Optional
To use this field, all the following fields CANNOT be used: *presetName* To use this field, all the following fields SHOULD be used: *amount* , *item*
The available values depends on each device. | | `presetName` | [String](https://developers.home.google.com/automations/schema/basics.md.txt#string) | Name of the preset to dispense. Optional
To use this field, all the following fields CANNOT be used: *amount* , *unit* , *item*
The available values depends on each device. | ## Examples ```yaml actions: - type: device.command.Dispense devices: My Device - Room Name item: Some String amount: 10 unit: Some String ```