---
metadata:
- name: generator
content: Diplodoc Platform v5.48.2
alternate:
- https://yandex.ru/dev/dialogs/smart-home/doc/en/concepts/capability-types.md
- https://yandex.ru/dev/dialogs/smart-home/doc/ru/concepts/capability-types.md
---
# About capabilities
A Capability is a [Device](https://yandex.ru/dev/dialogs/smart-home/doc/en/concepts/device-types.md) object property that describes its features, what it's capable of. Each device is described by at least one capability, provided it has no properties. Yandex Smart Home doesn't limit the providers in their choice of device capabilities, so users may have devices with a non-standard `device_type:capability` pair (for example, a TV can have the “temperature” function).
The smart home platform has a specific list of supported capabilities. If the provider's response to the request of [Information about user devices](https://yandex.ru/dev/dialogs/smart-home/doc/en/reference/get-devices.md) contains unknown capabilities, invalid format, or invalid values, the user will not be able to control the device.
{% note tip %}
To check the validity of parameters and view validation errors, use the [Testing](https://yandex.ru/dev/dialogs/smart-home/doc/en/testing.md) section in the [developer console](https://dialogs.yandex.ru/developer/).
{% endnote %}
Voice assistant Alice and the [ Home with Alice](https://alice.yandex.ru/smart-home) app use capabilities to build the device control model: Alice selects the appropriate voice control scenarios, and the Home with Alice app displays the corresponding controls and screens.
Depending on the operation performed, different sets of fields are passed in the Capability object:
1. The device capability description is used in the [Information about user devices](https://yandex.ru/dev/dialogs/smart-home/doc/en/reference/get-devices.md) operation:
```json translate=no
{
"type": {string},
"retrievable": {boolean},
"reportable": {boolean},
"parameters": {CapabilityParameterObject}
}
```
1. State of the device capability is used in the operations [Information about the states of user devices](https://yandex.ru/dev/dialogs/smart-home/doc/en/reference/post-devices-query.md), [Notification about device state change](https://yandex.ru/dev/dialogs/smart-home/doc/en/reference-alerts/post-skill_id-callback-state.md):
```json translate=no
{
"type": {string},
"state": {
"instance": {string},
"value": {InstanceValue}
}
}
```
1. Commands to control device capabilities are used in the [Change device state](https://yandex.ru/dev/dialogs/smart-home/doc/en/reference/post-action.md) operation:
```json translate=no
{
"type": {string},
"state": {
"instance": {string},
"value": {InstanceValue}
}
}
```
## Types of capabilities {#types}
#|
||
**Type of capability**
|
**Description**
||
||
[`on_off`](https://yandex.ru/dev/dialogs/smart-home/doc/en/concepts/on_off.md)
|
Remote device on/off (similar to pressing the power button on the device or its remote control). This is a basic capability for most devices.
||
||
[`color_setting`](https://yandex.ru/dev/dialogs/smart-home/doc/en/concepts/color_setting.md)
|
Color control for device lighting elements. The device may have one or more of the following functions:
- Changing the color of its lighting elements to any color from the [HSV](https://en.wikipedia.org/wiki/HSL_and_HSV) or [RGB](https://en.wikipedia.org/wiki/RGB_color_model) model.
- Changing the color temperature of its lighting elements.
- Playing back different visual effects.
||
||
[`mode`](https://yandex.ru/dev/dialogs/smart-home/doc/en/concepts/mode.md)
|
Switching device operation modes (for example, switching between air conditioner temperature modes: “Cooling”, “Heating”, or “Auto”).
||
||
[`range`](https://yandex.ru/dev/dialogs/smart-home/doc/en/concepts/range.md)
|
Control of device parameters that have a range of values. For example, the brightness of a lamp, the volume of sound, or the temperature of a heater.
||
||
[`toggle`](https://yandex.ru/dev/dialogs/smart-home/doc/en/concepts/toggle.md)
|
Control of device parameters that can only be in one of two states. For example, buttons, toggles, and similar controls that enable or disable an additional function of the device.
||
|#