diff --git a/source/_docs/configuration/templating.markdown b/source/_docs/configuration/templating.markdown index 4f75749683a..22e3470b26a 100644 --- a/source/_docs/configuration/templating.markdown +++ b/source/_docs/configuration/templating.markdown @@ -470,7 +470,7 @@ The same thing can also be expressed as a test: ### Floors - `floors()` returns the full list of floor IDs. -- `floor_id(lookup_value)` returns the floor ID for a given device ID, entity ID, area ID, or area name. Can also be used as a filter. +- `floor_id(lookup_value)` returns the floor ID for a given floor name or alias, area name or alias, entity ID or device ID. Can also be used as a filter. - `floor_name(lookup_value)` returns the floor name for a given device ID, entity ID, area ID, or floor ID. Can also be used as a filter. - `floor_areas(floor_name_or_id)` returns the list of area IDs tied to a given floor ID or name. Can also be used as a filter. - `floor_entities(floor_name_or_id)` returns the list of entity IDs tied to a given floor ID or name. Can also be used as a filter. @@ -487,6 +487,10 @@ The same thing can also be expressed as a test: {{ floor_id('First floor') }} # 'first_floor' ``` +```text +{{ floor_id('First floor alias') }} # 'first_floor' +``` + ```text {{ floor_id('my_device_id') }} # 'second_floor' ``` @@ -516,7 +520,7 @@ The same thing can also be expressed as a test: ### Areas - `areas()` returns the full list of area IDs -- `area_id(lookup_value)` returns the area ID for a given device ID, entity ID, or area name. Can also be used as a filter. +- `area_id(lookup_value)` returns the area ID for a given area name or alias, entity ID or device ID. Can also be used as a filter. - `area_name(lookup_value)` returns the area name for a given device ID, entity ID, or area ID. Can also be used as a filter. - `area_entities(area_name_or_id)` returns the list of entity IDs tied to a given area ID or name. Can also be used as a filter. - `area_devices(area_name_or_id)` returns the list of device IDs tied to a given area ID or name. Can also be used as a filter. @@ -533,6 +537,10 @@ The same thing can also be expressed as a test: {{ area_id('Living Room') }} # 'deadbeefdeadbeefdeadbeefdeadbeef' ``` +```text +{{ area_id('Living Room Alias') }} # 'deadbeefdeadbeefdeadbeefdeadbeef' +``` + ```text {{ area_id('my_device_id') }} # 'deadbeefdeadbeefdeadbeefdeadbeef' ```