diff --git a/source/_addons/duckdns.markdown b/source/_addons/duckdns.markdown index c6e929ffaf1..2f38bf80bd2 100644 --- a/source/_addons/duckdns.markdown +++ b/source/_addons/duckdns.markdown @@ -23,12 +23,13 @@ featured: true lets_encrypt: description: Let's Encrypt is a free, automated, and open certificate authority. required: true - type: list + type: map keys: accept_terms: description: If you accept the [Let's Encrypt Subscriber Agreement](https://letsencrypt.org/repository/), it will generate and update Let's Encrypt certificates for your DuckDNS domain. required: true type: boolean + default: false token: description: Your Duck DNS API key, from your DuckDNS account page. required: true diff --git a/source/_addons/homematic.markdown b/source/_addons/homematic.markdown index 38c7de7a16d..a49432b7b8b 100644 --- a/source/_addons/homematic.markdown +++ b/source/_addons/homematic.markdown @@ -44,6 +44,7 @@ rf_enable: description: Enable or disable BidCoS-RF. required: true type: boolean + default: false rf: description: RF devices. required: true @@ -61,6 +62,7 @@ wired_enable: description: Enable or disable BidCoS-Wired. required: true type: boolean + default: false wired: description: Wired devices. required: true @@ -82,6 +84,7 @@ hmip_enable: description: Enable or disable hmip. required: true type: boolean + default: false hmip: description: HMIP devices. required: true diff --git a/source/_addons/mosquitto.markdown b/source/_addons/mosquitto.markdown index 98fae3a8f14..e56242f703c 100644 --- a/source/_addons/mosquitto.markdown +++ b/source/_addons/mosquitto.markdown @@ -41,6 +41,7 @@ customize: description: If you enable it, it reads additional configuration files (`*.conf`) from `/share/mosquitto`. required: false type: [boolean, string] + default: false {% endconfiguration %} ### Home Assistant user management diff --git a/source/_addons/snips.markdown b/source/_addons/snips.markdown index 035b27e3944..cf74fa5e6db 100644 --- a/source/_addons/snips.markdown +++ b/source/_addons/snips.markdown @@ -57,6 +57,7 @@ language: custom_tts: description: Whether to use a TTS provider from Home Assistant for a variety of voices. type: boolean + default: false tts_platform: description: Which TTS platform to use. type: string diff --git a/source/_addons/tellstick.markdown b/source/_addons/tellstick.markdown index 3942739af85..dcc28085cd2 100644 --- a/source/_addons/tellstick.markdown +++ b/source/_addons/tellstick.markdown @@ -79,6 +79,7 @@ fade: description: Fade is either `true` or `false` and tells a dimmer if it should fade smooth or instant between values (only for IKEA protocol as it seems). required: false type: boolean + default: false code: description: A number series based on ones and zeroes often used for dip-switch based devices. required: false diff --git a/source/_components/light.knx.markdown b/source/_components/light.knx.markdown index 1b23b88ebbc..04372579312 100644 --- a/source/_components/light.knx.markdown +++ b/source/_components/light.knx.markdown @@ -66,12 +66,7 @@ color_temperature_state_address: required: false type: string color_temperature_mode: - description: Color temperature group address data type. - keys: - absolute: - description: color temperature in Kelvin. *color_temperature_address -> DPT 7.600* - relative: - description: color temperature in percent cold white (0% warmest; 100% coldest). *color_temperature_address -> DPT 5.001* + description: Color temperature group address data type. `absolute` color temperature in Kelvin. *color_temperature_address -> DPT 7.600*. `relative` color temperature in percent cold white (0% warmest; 100% coldest). *color_temperature_address -> DPT 5.001* required: false type: string default: absolute diff --git a/source/_components/light.mqtt.markdown b/source/_components/light.mqtt.markdown index 8dbd5badb50..a99761c1447 100644 --- a/source/_components/light.mqtt.markdown +++ b/source/_components/light.mqtt.markdown @@ -109,7 +109,7 @@ effect_value_template: effect_list: description: The list of effects the light supports. required: false - type: string list + type: [string, list] hs_command_topic: description: "The MQTT topic to publish commands to change the light's color state in HS format (Hue Saturation). Range for Hue: 0° .. 360°, Range of Saturation: 0..100. @@ -421,7 +421,7 @@ effect: effect_list: description: The list of effects the light supports. required: false - type: string list + type: [string, list] flash_time_long: description: The duration, in seconds, of a “long” flash. required: false @@ -691,7 +691,7 @@ unique_id: effect_list: description: List of possible effects. required: false - type: string list + type: [string, list] command_topic: description: The MQTT topic to publish commands to change the light’s state. required: true @@ -771,6 +771,7 @@ json_attributes_topic: json_attributes_template: description: "Defines a [template](/docs/configuration/templating/#processing-incoming-data) to extract the JSON dictionary from messages received on the `json_attributes_topic`. Usage example can be found in [MQTT sensor](/components/sensor.mqtt/#json-attributes-template-configuration) documentation." required: false + type: template device: description: 'Information about the device this light is a part of to tie it into the [device registry](https://developers.home-assistant.io/docs/en/device_registry_index.html). Only works through [MQTT discovery](/docs/mqtt/discovery/) and when [`unique_id`](#unique_id) is set.' required: false diff --git a/source/_components/logger.markdown b/source/_components/logger.markdown index 7149deb1e70..91c90ab03d4 100644 --- a/source/_components/logger.markdown +++ b/source/_components/logger.markdown @@ -57,9 +57,9 @@ logger: {% configuration %} default: - description: Default log level. + description: Default log level. See [log_level](#log-levels). required: false - type: '[log_level](#log-levels)' + type: string default: debug logs: description: List of integrations and their log level. @@ -67,8 +67,8 @@ logger: type: map keys: '<component_namespace>': - description: Logger namespace of the component. - type: '[log_level](#log-levels)' + description: Logger namespace of the component. See [log_level](#log-levels). + type: string {% endconfiguration %} ### Log Levels diff --git a/source/_components/magicseaweed.markdown b/source/_components/magicseaweed.markdown index 7433ed97d0b..2e86e36bd23 100644 --- a/source/_components/magicseaweed.markdown +++ b/source/_components/magicseaweed.markdown @@ -78,17 +78,10 @@ monitored_conditions: max_breaking_swell: description: The maximum wave height as the state with a detailed list of forecast attributes. units: - description: Specify the unit system. + description: Specify the unit system. Either `uk`, `eu` or `us`. required: false default: Default to `uk` or `us` based on the temperature preference in Home Assistant. type: string - keys: - uk: - description: Use UK units. - eu: - description: Use EU units. - us: - description: Use US units. {% endconfiguration %} Details about the API are available in the [Magicseaweed documentation](https://magicseaweed.com/developer/forecast-api). diff --git a/source/_components/manual.markdown b/source/_components/manual.markdown index 2d926f22f47..f8d3340621f 100644 --- a/source/_components/manual.markdown +++ b/source/_components/manual.markdown @@ -65,6 +65,7 @@ disarm_after_trigger: description: If true, the alarm will automatically disarm after it has been triggered instead of returning to the previous state. required: false type: boolean + default: false armed_custom_bypass/armed_home/armed_away/armed_night/disarmed/triggered: description: State specific settings required: false diff --git a/source/_components/manual_mqtt.markdown b/source/_components/manual_mqtt.markdown index eb4adeb9cfa..2d82aafa8a8 100644 --- a/source/_components/manual_mqtt.markdown +++ b/source/_components/manual_mqtt.markdown @@ -88,6 +88,7 @@ disarm_after_trigger: description: If true, the alarm will automatically disarm after it has been triggered instead of returning to the previous state. required: false type: boolean + default: false armed_home/armed_away/armed_night/disarmed/triggered: description: State specific settings required: false diff --git a/source/_components/met.markdown b/source/_components/met.markdown index 0c9dcc745a2..b7feec48b85 100644 --- a/source/_components/met.markdown +++ b/source/_components/met.markdown @@ -21,23 +21,24 @@ The `met` platform uses the [Met.no](https://met.no/) web service as a source fo To add Met.no to your installation, go to Configuration >> Integrations in the UI and enable the Met.no integration. By default the values will be taken from the Home Assistant configuration. {% configuration %} -name: - description: Manually specify Name. +name: + description: Manually specify Name. required: true + type: string default: Provided by Home Assistant configuration latitude: - description: Manually specify latitude. + description: Manually specify latitude. required: true - type: number + type: float default: Provided by Home Assistant configuration longitude: - description: Manually specify longitude. + description: Manually specify longitude. required: true - type: number + type: float default: Provided by Home Assistant configuration altitude: description: Manually specify altitude. required: false - type: number + type: integer default: Provided by Home Assistant configuration {% endconfiguration %} diff --git a/source/_components/miflora.markdown b/source/_components/miflora.markdown index 6c78e650d89..966f30e9eb6 100644 --- a/source/_components/miflora.markdown +++ b/source/_components/miflora.markdown @@ -91,6 +91,7 @@ force_update: description: Sends update events even if the value hasn't changed. required: false type: boolean + default: false median: description: "Sometimes the sensor measurements show spikes. Using this parameter, the poller will report the median of the last 3 (you can also use larger values) measurements. This filters out single spikes. Median: 5 will also filter double spikes. If you never have problems with spikes, `median: 1` will work fine." required: false diff --git a/source/_components/netdata.markdown b/source/_components/netdata.markdown index 0deca3fb283..85f178f2300 100644 --- a/source/_components/netdata.markdown +++ b/source/_components/netdata.markdown @@ -92,7 +92,7 @@ port: name: description: Name of the monitored Netdata instance. required: false - type: number + type: string default: Netdata resources: description: List of details to monitor. diff --git a/source/_components/nilu.markdown b/source/_components/nilu.markdown index 17bd10436c6..fc212b6f6b0 100644 --- a/source/_components/nilu.markdown +++ b/source/_components/nilu.markdown @@ -23,34 +23,34 @@ air_quality: ``` {% configuration %} - latitude: - description: Manually specify latitude. By default, the value will be taken from the Home Assistant configuration. - required: false - type: number - default: Provided by Home Assistant configuration. - longitude: - description: Manually specify longitude. By default, the value will be taken from the Home Assistant configuration. - required: false - type: number - default: Provided by Home Assistant configuration. - name: - description: Name of the sensor to use in the frontend. - required: false - default: NILU - type: string - area: - description: Name of an area to get sensor stations from. See available areas below. - required: exclusive - type: string - stations: - description: Name of a specific station to get measurements from. - required: exclusive - type: string - show_on_map: - description: Option to show the position of the sensor station on the map. - required: false - default: false - type: boolean +latitude: + description: Manually specify latitude. By default, the value will be taken from the Home Assistant configuration. + required: false + type: float + default: Provided by Home Assistant configuration. +longitude: + description: Manually specify longitude. By default, the value will be taken from the Home Assistant configuration. + required: false + type: float + default: Provided by Home Assistant configuration. +name: + description: Name of the sensor to use in the frontend. + required: false + default: NILU + type: string +area: + description: Name of an area to get sensor stations from. See available areas below. + required: exclusive + type: string +stations: + description: Name of a specific station to get measurements from. + required: exclusive + type: string +show_on_map: + description: Option to show the position of the sensor station on the map. + required: false + default: false + type: boolean {% endconfiguration %} ## Health risk index explainations diff --git a/source/_components/nissan_leaf.markdown b/source/_components/nissan_leaf.markdown index b6c0fd82cbd..76ae305b433 100644 --- a/source/_components/nissan_leaf.markdown +++ b/source/_components/nissan_leaf.markdown @@ -47,6 +47,7 @@ nissan_connect: description: If your car has the updated head unit (NissanConnect rather than Carwings) then the location can be aquired and exposed via a device tracker. If you have Carwings then this should be set to false. The easiest way to identify NissanConnect is if the T&C buttons are orange and blue, for CarWings they're both blue, or just look for anything saying "CarWings" in Settings area of the infotainment system. required: false type: boolean + default: true update_interval: description: The interval between updates if the climate control is off and the car is not charging. Set in any time unit (e.g. minutes, hours, days!). required: false diff --git a/source/_components/no_ip.markdown b/source/_components/no_ip.markdown index b7011daa526..61a4f50d6e3 100644 --- a/source/_components/no_ip.markdown +++ b/source/_components/no_ip.markdown @@ -37,6 +37,6 @@ no_ip: timeout: description: Timeout (in seconds) for the API calls. required: false - type: number + type: integer default: 10 {% endconfiguration %} diff --git a/source/_components/noaa_tides.markdown b/source/_components/noaa_tides.markdown index dd04e3cb897..380b57748d1 100644 --- a/source/_components/noaa_tides.markdown +++ b/source/_components/noaa_tides.markdown @@ -49,13 +49,8 @@ time_zone: lst_ldt: description: Local Standard/Local Daylight Time. The time local to the requested station. unit_system: - description: Specify the unit system. + description: Specify the unit system. Use `metric` (Celsius, meters, cm/s) or `english` (fahrenheit, feet, knots) units. required: false default: Defaults to `metric` or `imperial` based on the Home Assistant configuration. type: string - keys: - metric: - description: Metric (Celsius, meters, cm/s) units. - english: - description: English (fahrenheit, feet, knots) units. {% endconfiguration %} diff --git a/source/_components/norway_air.markdown b/source/_components/norway_air.markdown index a957d14bb11..babf6ddca85 100644 --- a/source/_components/norway_air.markdown +++ b/source/_components/norway_air.markdown @@ -31,11 +31,11 @@ forecast: latitude: description: Manually specify latitude. required: false - type: number + type: float default: Provided by Home Assistant configuration longitude: description: Manually specify longitude. required: false - type: number + type: float default: Provided by Home Assistant configuration {% endconfiguration %} diff --git a/source/_components/nx584.markdown b/source/_components/nx584.markdown index b6d7cf24f79..cca64ed6062 100644 --- a/source/_components/nx584.markdown +++ b/source/_components/nx584.markdown @@ -76,7 +76,7 @@ exclude_zones: zone_types: description: This is a list of zone numbers mapped to zone types. Use this to designate zones as doors, motion sensors, smoke detectors, etc. See the list of available zone types relevant to alarm zones below. required: false - type: map + type: list keys: opening: description: Opening diff --git a/source/_components/octoprint.markdown b/source/_components/octoprint.markdown index 3b038cd52af..19d9cf5f2d0 100644 --- a/source/_components/octoprint.markdown +++ b/source/_components/octoprint.markdown @@ -35,82 +35,78 @@ octoprint: ``` {% configuration %} -octoprint: - type: list +host: + description: IP address or hostname of Octoprint host. required: true + type: string +api_key: + description: The retrieved API key. + required: true + type: string +name: + description: The name for this printer, must be unique if multiple printers are defined. + required: false + type: string + default: OctoPrint +port: + description: The port of the Octoprint server. + required: false + type: integer + default: 80 +path: + description: The URL path of the Octoprint instance. + required: false + type: string + default: / +ssl: + description: Enable or disable SSL/TLS. + required: false + type: boolean + default: false +bed: + description: If the printer has a heated bed. + required: false + type: boolean + default: false +number_of_tools: + description: Number of temperature adjustable tools, e.g., nozzle. + required: false + type: integer + default: 0 +sensors: + description: Configuration for the sensors. + required: false + type: map keys: - host: - description: IP address or hostname of Octoprint host. - required: true - type: string - api_key: - description: The retrieved API key. - required: true - type: string - name: - description: The name for this printer, must be unique if multiple printers are defined. - required: false - type: string - default: OctoPrint - port: - description: The port of the Octoprint server. - required: false - type: integer - default: 80 - path: - description: The URL path of the Octoprint instance. - required: false - type: string - default: / - ssl: - description: Enable or disable SSL/TLS. - required: false - type: boolean - default: false - bed: - description: If the printer has a heated bed. - required: false - type: boolean - default: false - number_of_tools: - description: Number of temperature adjustable tools, e.g., nozzle. - required: false - type: integer - default: 0 - sensors: - description: Configuration for the sensors. - required: false - type: map + monitored_conditions: + description: The sensors to activate. + type: list + default: all (`Current State`, `Temperatures`, `Job Percentage`, `Time Elapsed`, `Time Remaining`) keys: - monitored_conditions: - description: The sensors to activate. - type: list - default: all (`Current State`, `Temperatures`, `Job Percentage`, `Time Elapsed`, `Time Remaining`) - keys: - "Current State": - description: Text of current state. - "Temperatures": - description: Temperatures of all available tools, e.g., `print`, `head`, `print bed`, etc. These will be displayed as `tool0`, `tool1`, or `toolN` please refer to your OctoPrint frontend to associate the tool number with an actual device. - "Job Percentage": - description: Percentage of the job. - "Time Elapsed": - description: Time elapsed on current print job, in seconds. - "Time Remaining": - description: Time remaining on current print job, in seconds. - binary_sensors: - description: Configuration for the binary sensors. - required: false - type: map + "Current State": + description: Text of current state. + "Temperatures": + description: Temperatures of all available tools, e.g., `print`, `head`, `print bed`, etc. These will be displayed as `tool0`, `tool1`, or `toolN` please refer to your OctoPrint frontend to associate the tool number with an actual device. + "Job Percentage": + description: Percentage of the job. + "Time Elapsed": + description: Time elapsed on current print job, in seconds. + "Time Remaining": + description: Time remaining on current print job, in seconds. +binary_sensors: + description: Configuration for the binary sensors. + required: false + type: map + keys: + monitored_conditions: + description: The sensors to activate. + type: list + default: all (`Printing`, `Printing Error`) keys: - monitored_conditions: - description: The sensors to activate. - type: list - default: all (`Printing`, `Printing Error`) - keys: - "Printing": - description: State of the printer. - "Printing Error": - description: Error while printing. + "Printing": + description: State of the printer. + "Printing Error": + description: Error while printing. {% endconfiguration %}
diff --git a/source/_components/onkyo.markdown b/source/_components/onkyo.markdown index 6b51a0095ba..9f067c37cf6 100644 --- a/source/_components/onkyo.markdown +++ b/source/_components/onkyo.markdown @@ -41,7 +41,7 @@ name: max_volume: description: Maximum volume. Defaults to 80. required: false - type: number + type: integer sources: description: A list of mappings from source to source name. Valid sources can be found below. A default list will be used if no source mapping is specified. required: false diff --git a/source/_components/owntracks.markdown b/source/_components/owntracks.markdown index 1191dd8fa91..2f8add4cfac 100644 --- a/source/_components/owntracks.markdown +++ b/source/_components/owntracks.markdown @@ -86,6 +86,7 @@ events_only: description: Home Assistant will ignore all location updates and rely solely on geofence enter/leave events. required: false type: boolean + default: false region_mapping: description: "Dictionary to remap names of regions as configured in the Owntracks app to Home Assistant zones. Use this if you have multiple homes or Home Assistant instances and want to map a different label to 'home'. `key: value` maps Owntracks region `key` to Home Assistant zone `value`." required: false diff --git a/source/_components/panel_custom.markdown b/source/_components/panel_custom.markdown index 965543511e6..6e0ee4b58b7 100644 --- a/source/_components/panel_custom.markdown +++ b/source/_components/panel_custom.markdown @@ -64,6 +64,7 @@ require_admin: description: If admin access is required to see this panel. required: false type: boolean + default: false embed_iframe: description: Set to `true` to embed panel in iframe. This is necessary if the panel is using the React framework or if it contains conflicting web components. required: false @@ -75,7 +76,7 @@ trust_external_script: default: false type: boolean webcomponent_path: - description: The HTML path to your component. If omitted will default to `/panels/.html` This is exclusive to `js_url` and `module_url`. - required: exclusive *DEPRECATED* + description: "*DEPRECATED* The HTML path to your component. If omitted will default to `/panels/.html` This is exclusive to `js_url` and `module_url`." + required: exclusive type: string {% endconfiguration %} diff --git a/source/_components/panel_iframe.markdown b/source/_components/panel_iframe.markdown index db2c96ebb89..503645da64f 100644 --- a/source/_components/panel_iframe.markdown +++ b/source/_components/panel_iframe.markdown @@ -33,32 +33,33 @@ panel_iframe: {% configuration %} - panel_iframe: - description: Enables the panel_iframe component. Only allowed once. - required: true - type: map - keys: - panel_name: - description: Name of the panel. Only allowed once. - required: true - type: map - keys: - title: - description: Friendly title for the panel. Will be used in the sidebar. - required: true - type: string - url: - description: The absolute URL or relative URL with an absolute path to open. - required: true - type: string - icon: - description: Icon for entry. - required: false - type: icon - require_admin: - description: If admin access is required to see this iframe. - required: false - type: boolean +panel_iframe: + description: Enables the panel_iframe component. Only allowed once. + required: true + type: map + keys: + panel_name: + description: Name of the panel. Only allowed once. + required: true + type: map + keys: + title: + description: Friendly title for the panel. Will be used in the sidebar. + required: true + type: string + url: + description: The absolute URL or relative URL with an absolute path to open. + required: true + type: string + icon: + description: Icon for entry. + required: false + type: icon + require_admin: + description: If admin access is required to see this iframe. + required: false + type: boolean + default: false {% endconfiguration %}
diff --git a/source/_components/pencom.markdown b/source/_components/pencom.markdown index 623f3c33d4a..dfdf13e0b8e 100644 --- a/source/_components/pencom.markdown +++ b/source/_components/pencom.markdown @@ -41,11 +41,11 @@ host: port: description: The port of the ethernet to serial adapter. required: true - type: integer (positive integer between 1-65535) + type: integer boards: description: Number of boards daisy-chained together (default is 1). required: false - type: int between 1 and 8 + type: integer relays: description: List of relays. required: true @@ -62,5 +62,5 @@ relays: board: description: The board number (defaults to 1). required: false - type: int between 1 and 8 + type: integer {% endconfiguration %} diff --git a/source/_components/pilight.markdown b/source/_components/pilight.markdown index 955cd6463b5..10ad3fdcd4e 100644 --- a/source/_components/pilight.markdown +++ b/source/_components/pilight.markdown @@ -116,6 +116,7 @@ disarm_after_trigger: description: Configure sensor as trigger type. required: false type: boolean + default: false reset_delay_sec: description: > Seconds before the sensor is disarmed if diff --git a/source/_components/proxy.markdown b/source/_components/proxy.markdown index 76f3c7888af..3ff68429c58 100644 --- a/source/_components/proxy.markdown +++ b/source/_components/proxy.markdown @@ -85,10 +85,12 @@ force_resize: description: Resize the image even if the resulting image would take up more bandwidth than the original. required: false type: boolean + default: false cache_images: description: Preserve the last image and re-send in the case the camera is not responding. required: false type: boolean + default: false {% endconfiguration %} ## Examples diff --git a/source/_components/rainbird.markdown b/source/_components/rainbird.markdown index a52153806d8..1b189adc420 100644 --- a/source/_components/rainbird.markdown +++ b/source/_components/rainbird.markdown @@ -63,6 +63,7 @@ sensor: {% configuration %} monitored_conditions: description: Conditions to be monitored. + type: list keys: rainsensor: description: Returns the sensor level. diff --git a/source/_components/raincloud.markdown b/source/_components/raincloud.markdown index d1c2ae9430f..39b4ce80f9c 100644 --- a/source/_components/raincloud.markdown +++ b/source/_components/raincloud.markdown @@ -118,10 +118,6 @@ monitored_conditions: keys: auto_watering: description: Toggle the watering scheduled per zone. - required: false - type: boolean manual_watering: description: Toggle manually the watering per zone. It will inherent the value in minutes specified on the RainCloud hub component. - required: false - type: boolean {% endconfiguration %} \ No newline at end of file diff --git a/source/_components/raspyrfm.markdown b/source/_components/raspyrfm.markdown index d7d5f796883..55892c1e7f0 100644 --- a/source/_components/raspyrfm.markdown +++ b/source/_components/raspyrfm.markdown @@ -72,7 +72,7 @@ switches: channel_config: description: Channel configuration of the control unit. The exact keys needed depend on the control unit manufacturer and model. required: true - type: dict + type: map {% endconfiguration %} ## Device support diff --git a/source/_components/recorder.markdown b/source/_components/recorder.markdown index d5892755c0c..f770db3fd89 100644 --- a/source/_components/recorder.markdown +++ b/source/_components/recorder.markdown @@ -49,11 +49,11 @@ recorder: domains: description: The list of domains to be excluded from recordings. required: false - type: List + type: list entities: description: The list of entity ids to be excluded from recordings. required: false - type: List + type: list include: description: Configure which integrations should be included in recordings. If set, all other entities will not be recorded. required: false @@ -62,11 +62,11 @@ recorder: domains: description: The list of domains to be included in the recordings. required: false - type: List + type: list entities: description: The list of entity ids to be included in the recordings. required: false - type: List + type: list {% endconfiguration %} Defining domains and entities to `exclude` (aka. blacklist) is convenient when you are basically happy with the information recorded, but just want to remove some entities or domains. Usually, these are entities/domains that do not change (like `weblink`) or rarely change (like `updater` or `automation`). diff --git a/source/_components/rejseplanen.markdown b/source/_components/rejseplanen.markdown index f52e840a407..cdfa7f78a64 100644 --- a/source/_components/rejseplanen.markdown +++ b/source/_components/rejseplanen.markdown @@ -56,15 +56,15 @@ stop_id: route: description: List of route names. required: false - type: string|list + type: [string, list] direction: description: List of directions to filter by. required: false - type: string|list + type: [string, list] departure_type: description: List of departure types to filter by. required: false - type: string|list + type: [string, list] {% endconfiguration %} ## Direction diff --git a/source/_components/remote.xiaomi_miio.markdown b/source/_components/remote.xiaomi_miio.markdown index 3e361e267a8..f72bf5b3f02 100644 --- a/source/_components/remote.xiaomi_miio.markdown +++ b/source/_components/remote.xiaomi_miio.markdown @@ -51,6 +51,7 @@ hidden: type: boolean default: true commands: + description: A list of commands required: false type: map keys: diff --git a/source/_components/repetier.markdown b/source/_components/repetier.markdown index d074417a836..9beb073756f 100644 --- a/source/_components/repetier.markdown +++ b/source/_components/repetier.markdown @@ -26,6 +26,7 @@ repetier: {% configuration %} repetier: + description: Repetier integration type: list required: true keys: diff --git a/source/_components/rest.markdown b/source/_components/rest.markdown index 0f3fa3acff8..ae7ea8213c8 100644 --- a/source/_components/rest.markdown +++ b/source/_components/rest.markdown @@ -68,7 +68,7 @@ verify_ssl: timeout: description: Defines max time to wait data from the endpoint. required: false - type: positive integer + type: integer default: 10 unit_of_measurement: description: Defines the units of measurement of the sensor, if any. diff --git a/source/_components/ritassist.markdown b/source/_components/ritassist.markdown index 83fd37d960f..d6d050fd279 100644 --- a/source/_components/ritassist.markdown +++ b/source/_components/ritassist.markdown @@ -52,7 +52,7 @@ password: include: description: A list of license plates to include, if this is not specified, all vehicles will be added. required: false - type: strings + type: list {% endconfiguration %} See the [device tracker integration page](/components/device_tracker/) for instructions on how to configure the people to be tracked. diff --git a/source/_components/sensor.modbus.markdown b/source/_components/sensor.modbus.markdown index 55410fd6c46..5b2ee02cc8f 100644 --- a/source/_components/sensor.modbus.markdown +++ b/source/_components/sensor.modbus.markdown @@ -75,8 +75,9 @@ registers: type: integer count: description: Number of registers to read. - required: integer + required: false type: integer + default: 1 reverse_order: description: Reverse the order of registers when count >1. required: false diff --git a/source/_components/sensor.mqtt.markdown b/source/_components/sensor.mqtt.markdown index 0dda9a30b76..d09e1b88356 100644 --- a/source/_components/sensor.mqtt.markdown +++ b/source/_components/sensor.mqtt.markdown @@ -79,6 +79,7 @@ json_attributes_topic: json_attributes_template: description: "Defines a [template](/docs/configuration/templating/#processing-incoming-data) to extract the JSON dictionary from messages received on the `json_attributes_topic`." required: false + type: template json_attributes: description: (Deprecated, replaced by json_attributes_topic) A list of keys to extract values from a JSON dictionary payload and then set as sensor attributes. required: false diff --git a/source/_components/simulated.markdown b/source/_components/simulated.markdown index 38248df1430..8f752d40962 100644 --- a/source/_components/simulated.markdown +++ b/source/_components/simulated.markdown @@ -63,7 +63,7 @@ period: description: The time in seconds for one complete oscillation of the periodic contribution. required: false default: 0 - type: seconds + type: integer phase: description: The phase offset (in degrees) to apply to the periodic component. required: false diff --git a/source/_components/skybeacon.markdown b/source/_components/skybeacon.markdown index 4c12c37ff4d..a6019472748 100644 --- a/source/_components/skybeacon.markdown +++ b/source/_components/skybeacon.markdown @@ -38,7 +38,7 @@ name: monitored_conditions: description: The parameters that should be monitored. required: false - type: map + type: list keys: temperature: description: Temperature at the sensor's location. diff --git a/source/_components/slack.markdown b/source/_components/slack.markdown index c450e71b173..195fdbdf4c1 100644 --- a/source/_components/slack.markdown +++ b/source/_components/slack.markdown @@ -45,6 +45,7 @@ notify: name: description: Setting this parameter allows multiple notifiers to be created. The notifier will bind to the service `notify.NOTIFIER_NAME`. required: false + type: string default: "notify" api_key: description: The Slack API token to use for sending Slack messages. @@ -62,6 +63,7 @@ username: icon: description: Use one of the Slack emojis as an Icon for the supplied username. Slack uses the standard emoji sets used [here](http://www.webpagefx.com/tools/emoji-cheat-sheet/). required: false + type: string {% endconfiguration %} ### Slack service data diff --git a/source/_components/sma.markdown b/source/_components/sma.markdown index 5a5f0ec2beb..8adc638dc77 100644 --- a/source/_components/sma.markdown +++ b/source/_components/sma.markdown @@ -55,10 +55,10 @@ group: default: user type: string sensors: - description: A dictionary of sensors that will be added. The value of the dictionary can include a list of sensor names that will be used as attributes. + description: A list of sensors that will be added. The value of the list can include a list of sensor names that will be used as attributes. required: false default: All sensors - type: map + type: list keys: pv_power: description: Current power generated by the inverter (W). diff --git a/source/_components/smhi.markdown b/source/_components/smhi.markdown index 3a043901e64..b4cc03f4c43 100644 --- a/source/_components/smhi.markdown +++ b/source/_components/smhi.markdown @@ -39,12 +39,12 @@ Only location close to Sweden can be added. See [SMHI.se area](http://opendata.s latitude: description: Manually specify latitude. required: false - type: number + type: float default: Provided by Home Assistant configuration longitude: description: Manually specify longitude. required: false - type: number + type: float default: Provided by Home Assistant configuration name: description: Name to use in the frontend. diff --git a/source/_components/solaredge.markdown b/source/_components/solaredge.markdown index adf0ff5b1e5..938b73c4ce9 100644 --- a/source/_components/solaredge.markdown +++ b/source/_components/solaredge.markdown @@ -127,6 +127,6 @@ sensors: platform: template sensors: solaredge_energy_this_year_template: - value_template: '{{(states('sensor.solaredge_energy_this_year') | float / 1000) | round(2)}}' + value_template: "{{ (states('sensor.solaredge_energy_this_year') | float / 1000) | round(2) }}" ``` {% endraw %} diff --git a/source/_components/solaredge_local.markdown b/source/_components/solaredge_local.markdown index a2f0129e713..2e146c5c9d1 100644 --- a/source/_components/solaredge_local.markdown +++ b/source/_components/solaredge_local.markdown @@ -58,11 +58,11 @@ In case you would like to convert the values for example to kWh instead of the d {% raw %} ```yaml -# Example configuration.yaml entry for template platform -sensors: - platform: template - sensors: - solaredge_energy_this_year_template: - value_template: '{{(states('sensor.solaredge_energy_this_year') | float / 1000) | round(2)}}' +# Example configuration.yaml entry for sensor template platform +sensor: + - platform: template + sensors: + solaredge_energy_this_year_template: + value_template: "{{ (states('sensor.solaredge_energy_this_year') | float / 1000) | round(2) }}" ``` {% endraw %} diff --git a/source/_components/spaceapi.markdown b/source/_components/spaceapi.markdown index 1d6f67c3350..a0e7e2bed7d 100644 --- a/source/_components/spaceapi.markdown +++ b/source/_components/spaceapi.markdown @@ -75,7 +75,7 @@ contact: issue_report_channels: description: "The reporting channel for issues. Pick an entity from `contact:`." required: true - type: List + type: list state: description: The current state of the Hackerspace. required: true @@ -84,7 +84,7 @@ state: entity_id: description: "The `entity_id` of a binary sensor that represents the current state." required: true - type: entity_id + type: string icon_open: description: The URL which is publicly accessible of the icon for the open Hackerspace. required: false @@ -101,11 +101,11 @@ sensors: temperature: description: List of temperature sensors. required: true - type: entity_id + type: string humidity: description: List of humidity sensors. required: true - type: entity_id + type: string {% endconfiguration %} The list of sensors can be any sensor, not just temperature or humidity. diff --git a/source/_components/threshold.markdown b/source/_components/threshold.markdown index 72c404ab225..da70c25cf05 100644 --- a/source/_components/threshold.markdown +++ b/source/_components/threshold.markdown @@ -39,7 +39,7 @@ binary_sensor: entity_id: description: "The entity to monitor. Only [sensors](/components/sensor/) are supported." required: true - type: entity_id + type: string lower: description: The lower threshold which the observed value is compared against. required: false diff --git a/source/_components/tile.markdown b/source/_components/tile.markdown index 4182fb6c284..b9eda0b6b75 100644 --- a/source/_components/tile.markdown +++ b/source/_components/tile.markdown @@ -41,6 +41,7 @@ device_tracker: description: whether to show expired/disabled Tiles required: false type: boolean + default: false {% endconfiguration %} Multiple Tile accounts can be used by repeating the `tile` platform. Tracked devices in `known_devices.yaml` will be named `tile_`. You can find `` in the Tile app by clicking on a tile. diff --git a/source/_components/tod.markdown b/source/_components/tod.markdown index c44d6ded94d..7ce320b4954 100644 --- a/source/_components/tod.markdown +++ b/source/_components/tod.markdown @@ -44,7 +44,7 @@ name: before: description: The absolute local time value or sun event for beginning of the time range. required: true - type: string or time + type: [string, time] before_offset: description: The time offset of the beginning time range. required: false @@ -52,7 +52,7 @@ before_offset: after: description: The absolute local time value or sun event for ending of the time range. required: true - type: string or time + type: [string, time] after_offset: description: The time offset of the beginning time range. type: time diff --git a/source/_components/trafikverket_weatherstation.markdown b/source/_components/trafikverket_weatherstation.markdown index c0e39a1af47..e661dde93ff 100644 --- a/source/_components/trafikverket_weatherstation.markdown +++ b/source/_components/trafikverket_weatherstation.markdown @@ -56,7 +56,7 @@ station: monitored_conditions: description: Specify what measurement data to retrieve from the weather station. required: true - type: map + type: list keys: air_temp: description: Air temperature. diff --git a/source/_components/transmission.markdown b/source/_components/transmission.markdown index 7abb85bc599..68b10f9377b 100644 --- a/source/_components/transmission.markdown +++ b/source/_components/transmission.markdown @@ -64,6 +64,7 @@ turtle_mode: description: If enabled, it creates a switch entity to control the 'Alternative Speed Limits' (aka 'Turtle mode') setting. required: false type: boolean + default: false scan_interval: description: How frequently to query for new data. Defaults to 120 seconds. required: false @@ -72,7 +73,7 @@ monitored_conditions: type: integer description: "List of monitored conditions. Possible values are:" required: false - type: map + type: list keys: current_status: description: The status of your Transmission daemon. diff --git a/source/_components/twitch.markdown b/source/_components/twitch.markdown index c0985ff90d8..5bebfa43bd4 100644 --- a/source/_components/twitch.markdown +++ b/source/_components/twitch.markdown @@ -36,10 +36,7 @@ client_id: required: true type: string channels: - description: List of channels. + description: List of channels names required: true - type: map - keys: - channel_id: - description: Name of the channel. + type: list {% endconfiguration %} diff --git a/source/_components/unifi.markdown b/source/_components/unifi.markdown index 07fb8be98f6..7f94a7dacd9 100644 --- a/source/_components/unifi.markdown +++ b/source/_components/unifi.markdown @@ -60,7 +60,7 @@ detection_time: default: 300 ssid_filter: description: Filter the SSIDs that tracking will occur on. - type: list of strings + type: list required: false default: None {% endconfiguration %} diff --git a/source/_components/vacuum.mqtt.markdown b/source/_components/vacuum.mqtt.markdown index 4155f2489cb..bf80d589eb4 100644 --- a/source/_components/vacuum.mqtt.markdown +++ b/source/_components/vacuum.mqtt.markdown @@ -42,7 +42,7 @@ schema: supported_features: description: List of features that the vacuum supports (possible values are `turn_on`, `turn_off`, `pause`, `stop`, `return_home`, `battery`, `status`, `locate`, `clean_spot`, `fan_speed`, `send_command`)." required: false - type: string list + type: [string, list] default: "`turn_on`, `turn_off`, `stop`, `return_home`, `status`, `battery`, `clean_spot`" command_topic: description: The MQTT topic to publish commands to control the vacuum. @@ -148,7 +148,7 @@ set_fan_speed_topic: fan_speed_list: description: List of possible fan speeds for the vacuum. required: false - type: string list + type: [string, list] send_command_topic: description: The MQTT topic to publish custom commands to the vacuum. required: false @@ -273,7 +273,7 @@ schema: supported_features: description: "List of features that the vacuum supports (possible values are `start`, `stop`, `pause`, `return_home`, `battery`, `status`, `locate`, `clean_spot`, `fan_speed`, `send_command`)." required: false - type: string list + type: [string, list] default: "`start`, `stop`, `return_home`, `status`, `battery`, `clean_spot`" command_topic: description: The MQTT topic to publish commands to control the vacuum. @@ -334,7 +334,7 @@ set_fan_speed_topic: fan_speed_list: description: List of possible fan speeds for the vacuum. required: false - type: string list + type: [string, list] send_command_topic: description: The MQTT topic to publish custom commands to the vacuum. required: false diff --git a/source/_components/volkszaehler.markdown b/source/_components/volkszaehler.markdown index 3400cceead5..a7b5db9b73c 100644 --- a/source/_components/volkszaehler.markdown +++ b/source/_components/volkszaehler.markdown @@ -46,7 +46,7 @@ name: monitored_conditions: description: Entries to monitor. required: false - type: map + type: list default: average keys: average: diff --git a/source/_components/vultr.markdown b/source/_components/vultr.markdown index 8c57009bf4c..3cec3889126 100644 --- a/source/_components/vultr.markdown +++ b/source/_components/vultr.markdown @@ -130,8 +130,8 @@ monitored_conditions: keys: current_bandwidth_used: description: The current (invoice period) bandwidth usage in Gigabytes (GB). - temperature: - pending_charges: The current (invoice period) charges that have built up for this subscription. Value is in US Dollars (US$). + pending_charges: + description: The current (invoice period) charges that have built up for this subscription. Value is in US Dollars (US$). {% endconfiguration %} Full `configuration.yaml` using `{}` to format condition name (produces `sensor.server_current_bandwidth_used` and `sensor.server_pending_charges`): diff --git a/source/_components/waze_travel_time.markdown b/source/_components/waze_travel_time.markdown index 95c18f5d8ab..5a279e2d85a 100644 --- a/source/_components/waze_travel_time.markdown +++ b/source/_components/waze_travel_time.markdown @@ -57,6 +57,7 @@ realtime: description: If this is set to false, Waze returns the time estimate, not including current conditions, but rather the average travel time for the current time of day. The parameter defaults to true, meaning Waze will return real-time travel time. required: false type: boolean + default: true units: description: "Set the unit for the sensor in metric or imperial, otherwise the default unit the same as the unit set in `unit_system:`." required: false diff --git a/source/_components/weather.darksky.markdown b/source/_components/weather.darksky.markdown index 30906a6fc9f..0b2e94c4a72 100644 --- a/source/_components/weather.darksky.markdown +++ b/source/_components/weather.darksky.markdown @@ -38,12 +38,12 @@ api_key: latitude: description: Manually specify latitude. By default the value will be taken from the Home Assistant configuration. required: false - type: number + type: float default: Provided by Home Assistant configuration longitude: description: Manually specify longitude. By default the value will be taken from the Home Assistant configuration. required: false - type: number + type: float default: Provided by Home Assistant configuration units: description: "Manually specify unit system. Valid values are: `auto`, `us`, `si`, `ca`, `uk` and `uk2`." diff --git a/source/_components/xmpp.markdown b/source/_components/xmpp.markdown index f1902f1217f..9db60f3a3b3 100644 --- a/source/_components/xmpp.markdown +++ b/source/_components/xmpp.markdown @@ -44,9 +44,11 @@ resource: password: description: The password for your given Jabber account. required: true + type: string recipient: description: The Jabber ID (JID) that will receive the messages. required: true + type: string tls: description: Force TLS. required: false diff --git a/source/_components/yeelight.markdown b/source/_components/yeelight.markdown index 61d718029ee..cfc496bf392 100644 --- a/source/_components/yeelight.markdown +++ b/source/_components/yeelight.markdown @@ -80,7 +80,7 @@ devices: custom_effects: description: List of custom effects to add. Check examples below. required: false - type: array + type: map keys: name: description: Name of effect. @@ -99,8 +99,7 @@ custom_effects: transitions: description: List of transitions, for that effect, check [example](#custom-effects). required: true - type: array - + type: list {% endconfiguration %} #### Music mode diff --git a/source/_components/zabbix.markdown b/source/_components/zabbix.markdown index 0233eeb5b67..e4e16f4bb6f 100644 --- a/source/_components/zabbix.markdown +++ b/source/_components/zabbix.markdown @@ -101,4 +101,5 @@ individual: description: A 'true'/'false' to specify whether we should show individual sensors when a list of hostids is provided. If false, the sensor state will be the count of all triggers for the specified hosts (or all hosts within the Zabbix instance, if hostids isn't provided). required: false type: boolean -{% endconfiguration %} \ No newline at end of file + default: false +{% endconfiguration %} diff --git a/source/_docs/authentication/providers.markdown b/source/_docs/authentication/providers.markdown index 05ab67b87a1..85bf56dd89d 100644 --- a/source/_docs/authentication/providers.markdown +++ b/source/_docs/authentication/providers.markdown @@ -80,15 +80,20 @@ homeassistant: trusted_networks: description: A list of IP address or IP network you want to whitelisted. It accepts both IPv4 and IPv6 IP address or network required: true - type: list of string + type: list trusted_users: description: You can also assign which users are available to select when user access login page from certain IP address or network. required: false - type: dictionary, string as key, list of string as value + type: map + keys: + IP_ADDRESS: + description: List of users available to select on this IP address or network. + required: false + type: [list, string] allow_bypass_login: description: You can bypass login page if you have only one user available for selection. required: false - default: False + default: false type: boolean {% endconfiguration %} diff --git a/source/_docs/automation/templating.markdown b/source/_docs/automation/templating.markdown index 1349bb7ad2b..eb68f068c61 100644 --- a/source/_docs/automation/templating.markdown +++ b/source/_docs/automation/templating.markdown @@ -72,6 +72,8 @@ There are a few very important rules to remember when writing automation templat Remembering these simple rules will help save you from many headaches and endless hours of frustration when using automation templates. +It is possible to use `data` and `data_template` concurrently but be aware that `data_template` will overwrite attributes that are provided in both. + ## Trigger State Object Knowing how to access the [state object](/docs/configuration/state_object/) of a trigger entity could be one of the more common questions. Here are a few ways for the [`state`](#state), [`numeric_state`](#numeric_state) and [`template`](#template) triggers: diff --git a/source/_docs/mqtt/broker.markdown b/source/_docs/mqtt/broker.markdown index 9dad09aefeb..cdb68d0c496 100644 --- a/source/_docs/mqtt/broker.markdown +++ b/source/_docs/mqtt/broker.markdown @@ -54,6 +54,7 @@ tls_insecure: required: false description: Set the verification of the server hostname in the server certificate. type: boolean + default: false tls_version: required: false description: "TLS/SSL protocol version to use. Available options are: `'auto'`, `'1.0'`, `'1.1'`, `'1.2'`. Make sure to put quotes around the value. Defaults to `'auto'`." diff --git a/source/_docs/scripts/service-calls.markdown b/source/_docs/scripts/service-calls.markdown index 77229e1fe65..aaa6c10b56a 100644 --- a/source/_docs/scripts/service-calls.markdown +++ b/source/_docs/scripts/service-calls.markdown @@ -77,6 +77,16 @@ data_template: temperature: {% raw %}{{ 22 - distance(states.device_tracker.paulus) }}{% endraw %} ``` +It is even possible to use `data` and `data_template` concurrently but be aware that `data_template` will overwrite attributes that are provided in both. + +```yaml +service: thermostat.set_temperature +data: + entity_id: thermostat.upstairs +data_template: + temperature: {% raw %}{{ 22 - distance(states.device_tracker.paulus) }}{% endraw %} +``` + ### `homeassistant` services There are four `homeassistant` services that aren't tied to any single domain, these are: diff --git a/source/_lovelace/conditional.markdown b/source/_lovelace/conditional.markdown index 7df1118ab3f..e26ee05ca74 100644 --- a/source/_lovelace/conditional.markdown +++ b/source/_lovelace/conditional.markdown @@ -31,7 +31,7 @@ conditions: card: required: true description: Card to display if all conditions match. - type: object + type: map {% endconfiguration %} *one is required (`state` or `state_not`) diff --git a/source/_lovelace/entities.markdown b/source/_lovelace/entities.markdown index f07667d07bf..fa561811b48 100644 --- a/source/_lovelace/entities.markdown +++ b/source/_lovelace/entities.markdown @@ -91,7 +91,7 @@ action_name: service_data: required: false description: The service data to use. - type: object + type: map {% endconfiguration %} ### Divider @@ -104,7 +104,7 @@ type: style: required: false description: Style the element using CSS. - type: object + type: string default: "height: 1px, background-color: var(--secondary-text-color)" {% endconfiguration %} diff --git a/source/_lovelace/entity-button.markdown b/source/_lovelace/entity-button.markdown index af60f750093..505584bdecb 100644 --- a/source/_lovelace/entity-button.markdown +++ b/source/_lovelace/entity-button.markdown @@ -53,7 +53,7 @@ icon_height: tap_action: required: false description: Action to take on tap - type: object + type: map keys: action: required: true @@ -78,7 +78,7 @@ tap_action: hold_action: required: false description: Action to take on tap-and-hold - type: object + type: map keys: action: required: true diff --git a/source/_lovelace/entity-filter.markdown b/source/_lovelace/entity-filter.markdown index 69d324359ea..869ad2b3135 100644 --- a/source/_lovelace/entity-filter.markdown +++ b/source/_lovelace/entity-filter.markdown @@ -29,7 +29,7 @@ state_filter: card: required: false description: Extra options to pass down to the card rendering the result. - type: object + type: map default: entities card show_empty: required: false diff --git a/source/_lovelace/glance.markdown b/source/_lovelace/glance.markdown index 7be12fbab7d..b8678f374fb 100644 --- a/source/_lovelace/glance.markdown +++ b/source/_lovelace/glance.markdown @@ -69,7 +69,7 @@ icon: tap_action: required: false description: Action to take on tap - type: object + type: map keys: action: required: true @@ -94,7 +94,7 @@ tap_action: hold_action: required: false description: Action to take on tap-and-hold - type: object + type: map keys: action: required: true diff --git a/source/_lovelace/picture-elements.markdown b/source/_lovelace/picture-elements.markdown index cde84c378c7..0b4ca1a0760 100644 --- a/source/_lovelace/picture-elements.markdown +++ b/source/_lovelace/picture-elements.markdown @@ -48,7 +48,7 @@ entity: style: required: true description: Position and style the element using CSS. - type: object + type: map default: "position: absolute, transform: translate(-50%, -50%)" title: required: false @@ -78,7 +78,7 @@ title: tap_action: required: false description: Action to take on tap - type: object + type: map keys: action: required: true @@ -103,7 +103,7 @@ tap_action: hold_action: required: false description: Action to take on tap-and-hold - type: object + type: map keys: action: required: true @@ -128,7 +128,7 @@ hold_action: style: required: true description: Position and style the element using CSS. - type: object + type: string default: "position: absolute, transform: translate(-50%, -50%)" {% endconfiguration %} @@ -158,7 +158,7 @@ title: tap_action: required: false description: Action to take on tap - type: object + type: map keys: action: required: true @@ -183,7 +183,7 @@ tap_action: hold_action: required: false description: Action to take on tap-and-hold - type: object + type: map keys: action: required: true @@ -208,7 +208,7 @@ hold_action: style: required: true description: Position and style the element using CSS. - type: object + type: string default: "position: absolute, transform: translate(-50%, -50%)" {% endconfiguration %} @@ -230,11 +230,11 @@ service: service_data: required: false description: The service data to use. - type: object + type: map style: required: true description: Position and style the element using CSS. - type: object + type: string default: "position: absolute, transform: translate(-50%, -50%)" {% endconfiguration %} @@ -260,7 +260,7 @@ entity: tap_action: required: false description: Action to take on tap - type: object + type: map keys: action: required: true @@ -285,7 +285,7 @@ tap_action: hold_action: required: false description: Action to take on tap-and-hold - type: object + type: map keys: action: required: true @@ -310,7 +310,7 @@ hold_action: style: required: true description: Position and style the element using CSS. - type: object + type: string default: "position: absolute, transform: translate(-50%, -50%)" {% endconfiguration %} @@ -332,7 +332,7 @@ title: tap_action: required: false description: Action to take on tap - type: object + type: map keys: action: required: true @@ -357,7 +357,7 @@ tap_action: hold_action: required: false description: Action to take on tap-and-hold - type: object + type: map keys: action: required: true @@ -395,7 +395,7 @@ camera_view: state_image: required: false description: '[State-based images](#how-to-use-state_image)' - type: object + type: map filter: required: false description: Default CSS filter @@ -403,7 +403,7 @@ filter: state_filter: required: false description: '[State-based CSS filters](#how-to-use-state_filter)' - type: object + type: map aspect_ratio: required: false description: Height-width-ratio. @@ -412,7 +412,7 @@ aspect_ratio: style: required: true description: Position and style the element using CSS. - type: object + type: string default: "position: absolute, transform: translate(-50%, -50%)" {% endconfiguration %} @@ -458,7 +458,7 @@ type: style: required: true description: Position and style the element using CSS. - type: object + type: string default: "position: absolute, transform: translate(-50%, -50%)" {% endconfiguration %} diff --git a/source/_lovelace/picture-entity.markdown b/source/_lovelace/picture-entity.markdown index 3225e190e65..f5d70a8c936 100644 --- a/source/_lovelace/picture-entity.markdown +++ b/source/_lovelace/picture-entity.markdown @@ -36,7 +36,7 @@ image: state_image: required: false description: "Map entity states to images (`state: image URL`, check the example below)." - type: object + type: map aspect_ratio: required: false description: "Forces the height of the image to be a ratio of the width. You may enter a value such as: `16x9`, `16:9`, `1.78`." @@ -58,7 +58,7 @@ show_state: tap_action: required: false description: Action to take on tap - type: object + type: map keys: action: required: true @@ -83,7 +83,7 @@ tap_action: hold_action: required: false description: Action to take on tap-and-hold - type: object + type: map keys: action: required: true diff --git a/source/_lovelace/picture-glance.markdown b/source/_lovelace/picture-glance.markdown index 42d98123222..33dc065843e 100644 --- a/source/_lovelace/picture-glance.markdown +++ b/source/_lovelace/picture-glance.markdown @@ -40,7 +40,7 @@ camera_view: state_image: required: false description: Background image based on entity state. - type: object + type: map keys: state: type: string @@ -57,7 +57,7 @@ entity: tap_action: required: false description: Action to take on tap - type: object + type: map keys: action: required: true @@ -82,7 +82,7 @@ tap_action: hold_action: required: false description: Action to take on tap-and-hold - type: object + type: map keys: action: required: true diff --git a/source/_lovelace/picture.markdown b/source/_lovelace/picture.markdown index c1ccdf77d66..65c9befd801 100644 --- a/source/_lovelace/picture.markdown +++ b/source/_lovelace/picture.markdown @@ -23,7 +23,7 @@ image: tap_action: required: false description: Action to take on tap - type: object + type: map keys: action: required: true @@ -48,7 +48,7 @@ tap_action: hold_action: required: false description: Action to take on tap-and-hold - type: object + type: map keys: action: required: true diff --git a/source/_posts/2019-07-17-release-96.markdown b/source/_posts/2019-07-17-release-96.markdown index 00ee3d2ea97..94a77dfed9e 100644 --- a/source/_posts/2019-07-17-release-96.markdown +++ b/source/_posts/2019-07-17-release-96.markdown @@ -85,6 +85,10 @@ Big shout out to [@frenck] who has been doing a lot of clean up on the website. Last week [@balloob] showed a preview of the upcoming [Home Assistant Cast](/blog/2019/07/09/home-assistant-cast-preview/), a new interface for Home Assistant that runs on Chromecasts and Google Assistant devices with screens. +The [Home Assistant code repository on GitHub](https://github.com/home-assistant/home-assistant) has hit 25.000 stars! 🤩 + +The Home Assistant Podcast has published [episode 53](https://hasspodcast.io/ha053/) to discuss all the ins and outs of this new release. + [@teachingbirds] has redone her Lovelace UI and it is looking fabulous!