---
metadata:
  - name: generator
    content: Diplodoc Platform v5.48.2
alternate:
  - https://yandex.ru/dev/dialogs/smart-home/doc/en/concepts/properties-types.md
  - https://yandex.ru/dev/dialogs/smart-home/doc/ru/concepts/properties-types.md
---
# About properties

<!-- <note type="restriction">
            <p>На текущий момент свойства отображаются только в интерфейсе устройств и не участвуют в голосовых сценариях.</p>
        </note> -->

**Properties** are the [Device](https://yandex.ru/dev/dialogs/smart-home/doc/en/concepts/device-types.md) object properties that describe capabilities. Using `properties`, you can report data from device properties. Properties are usually used to monitor the environment. A device may not have any properties.

Yandex Smart Home doesn't limit the providers in their choice of device properties, so users may have devices with a non-standard `device_type:property` pair (for example, a TV can have the “humidity” property).

The smart home platform has a specific list of supported properties. 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 properties that are unknown, have an invalid format, or have invalid values, the device will be rejected and the user will not be able to control it.


{% 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 %}

<!-- <p>На основе заданных свойств голосовой помощник Алиса или поисковое приложение Яндекса строят модель управления устройством: Алиса выбирает соответствующие голосовые сценарии управления, а поисковое приложение отображает соответствующие свойствам элементы управления и экраны.</p> -->

Depending on the operation performed, different sets of fields are passed in the Property object:

1. The device property 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": {PropertyParametersObject}
    }
    ```

1. The status of the device property is used in the [Information about the states of user devices](https://yandex.ru/dev/dialogs/smart-home/doc/en/reference/post-devices-query.md) operation:

    ```json translate=no
    {
        "type": {string},
        "state": {
            "instance": {string},
            "value": {InstanceValue}
        }
    }
    ```

### Property types {#types}

#|
||
**Property type**
|
**Description**
||

||
[`float`](https://yandex.ru/dev/dialogs/smart-home/doc/en/concepts/float.md)
|
<!-- source: en/_includes/concepts/float/id-float/abstract.md -->
Displaying device property values in numeric format.
<!-- endsource: en/_includes/concepts/float/id-float/abstract.md -->
||

||
[`event`](https://yandex.ru/dev/dialogs/smart-home/doc/en/concepts/event.md)
|
<!-- source: en/_includes/concepts/event/id-event/abstract.md -->
Display of readings of device properties (properties can have one of the specified states).
<!-- endsource: en/_includes/concepts/event/id-event/abstract.md -->
||
|#

<!-- <row>
                            <entry><xref href="color_setting.dita"><codeph>color_setting</codeph></xref></entry>
                            <entry><p conref="color_setting.dita#color_setting/abstract"/></entry>
                        </row> -->
<!-- <row>
                            <entry><xref href="mode.dita"><codeph>mode</codeph></xref></entry>
                            <entry><p conref="mode.dita#mode/abstract"></p></entry>
                        </row> -->

<!-- {% include [support-support-button](../_includes/about/id-support/support-button.md) %}-->