Skip to article frontmatterSkip to article content
Core extensions

Floors management

Floors brings Home Assistant to a whole new level 🤪

Floors in Home Assistant is a logical grouping of areas that are meant to match floors (or levels) in the physical world: your home. Floors are used to group areas together that are on the same floor in your home. Floors give a better overview of your home and can be used to target actions to a specific floor, like turning off all the lights on the first floor.

Spook provides that allows you to manage and automate the floors in Home Assistant programatically. Great for creating “dynamic” floors, or for creating floors on the fly.

Screenshot of the developer action tools, listing the new actions to manage floors.

Actions

Spook adds the following new actions to your Home Assistant instance:

Create a floor

Adds a new floor to your Home Assistant instance.

Screenshot of the create floor action in the developer tools.

Action properties

Action

Create a floor 👻

Action name

homeassistant.create_floor

Action targets

No

Action response

No response

Spook's influence

Newly added action

Developer tools

Try this action Open your Home Assistant instance and show your actions developer tools with a specific action selected.

Action data parameters

Attribute

Type

Required

Default / Example

name

string

Yes

First floor

icon

string

No

mdi:floor-1

level

integer

No

1

aliases

string | list of strings

No

["ground floor", "downstairs"]

The use of aliases is helpful if you want to create an floor with multiple names. For example, if you want to create an floor called “First floor”, but also want to be able to refer to it as “Ground floor” or “Downstairs”, you can add those names as aliases. This is used by Home Assistant Assist.

Delete a floor

Delete a floor from your Home Assistant instance.

Screenshot of the delete flor action in the developer tools.

Action properties

Action

Delete a floor 👻

Action name

homeassistant.delete_floor

Action targets

No

Action response

No response

Spook's influence

Newly added action

Developer tools

Try this action Open your Home Assistant instance and show your actions developer tools with a specific action selected.

Action data parameters

Attribute

Type

Required

Default / Example

floor_id

string

Yes

first_floor

Add an alias to a floor

Adds one or more aliases to an existing floor. This action does not remove existing aliases, but adds the new ones to the existing ones.

As floor aliases are used by voice assistants, you could add (and also remove) aliases to a floor using automations, which allows you to make them available/unavailable programatically.

Screenshot of the add an alias to a floor action in the developer tools.

Action properties

Action

Add an alias to a floor 👻

Action name

homeassistant.add_alias_to_floor

Action targets

No

Action response

No response

Spook's influence

Newly added action

Developer tools

Try this action Open your Home Assistant instance and show your actions developer tools with a specific action selected.

Action data parameters

Attribute

Type

Required

Default / Example

floor_id

string

Yes

first_floor

aliases

string | list of strings

Yes

["Ground floor", "Downstairs"]

Remove an alias from a floor

Removes one or more aliases from an existing floor. This action will leave the other aliases intact.

As floor aliases are used by voice assistants, you could remove (and also add) aliases to a floor using automations, which allows you to make them available/unavailable programatically.

Screenshot of the remove an alias to a floor action in the developer tools.

Action properties

Action

Add an alias to a floor 👻

Action name

homeassistant.remove_alias_from_floor

Action targets

No

Action response

No response

Spook's influence

Newly added action

Developer tools

Try this action Open your Home Assistant instance and show your actions developer tools with a specific action selected.

Action data parameters

Attribute

Type

Required

Default / Example

floor_id

string

Yes

first_floor

aliases

string | list of strings

Yes

["Ground floor", "Downstairs"]

Set aliases for a floor

Sets the aliases for a floor. This action will overwrite/remove all existing aliases.

As floor aliases are used by voice assistants, you could remove (and also add) aliases to a floor using automations, which allows you to make them available/unavailable programatically.

Screenshot of the set aliases to for a floor action in the developer tools.

Action properties

Action

Sets aliases for a floor 👻

Action name

homeassistant.set_floor_aliases

Action targets

No

Action response

No response

Spook's influence

Newly added action

Developer tools

Try this action Open your Home Assistant instance and show your actions developer tools with a specific action selected.

Action data parameters

Attribute

Type

Required

Default / Example

floor_id

string

Yes

first_floor

aliases

string | list of strings

Yes

["Ground floor", "Downstairs"]

Add an area to a floor

Adds one or more area(s) to a floor. This action will leave the other areas on the floor untouched.

Screenshot of the add an area to a floor action in the developer tools.

Action properties

Action

Add an area to a floor 👻

Action name

homeassistant.add_area_to_floor

Action targets

No

Action response

No response

Spook's influence

Newly added action

Developer tools

Try this action Open your Home Assistant instance and show your actions developer tools with a specific action selected.

Action data parameters

Attribute

Type

Required

Default / Example

floor_id

string

Yes

first_floor

area_id

string | list of strings

Yes

living_room

Remove an area from a floor

Removes one or more area(s) from a floor. This action will leave the other area on the floor untouched.

Screenshot of the add a device to an area action in the developer tools.

Action properties

Action

Remove an area from a floor 👻

Action name

homeassistant.remove_area_from_floor

Action targets

No

Action response

No response

Spook's influence

Newly added action

Developer tools

Try this action Open your Home Assistant instance and show your actions developer tools with a specific action selected.

Action data parameters

Attribute

Type

Required

Default / Example

area_id

string | list of strings

Yes

living_room

Blueprints & tutorials

There are currently no known blueprints or tutorials for the enhancements Spook provides for this integration. If you created one or stumbled upon one, please let us know in our discussion forums.

Features requests, ideas, and support

If you have an idea on how to further enhance this integration, for example, by adding a new action, entity, or repairs detection; feel free to let us know in our discussion forums.

Are you stuck using these new features? Or maybe you’ve run into a bug? Please check the page on where to go for help.