# Floor

The "Floor" widget shows an overview of a floor with a selection of assets located on the floor.

<div data-full-width="true"><figure><img src="https://3489494878-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9GvUpaatBiReR43XFSMg%2Fuploads%2F98xJJtDYWvfQGUVbvoEY%2F233C9D3C-836E-4C2E-9C86-214839137839.png?alt=media&#x26;token=50780d14-fea7-4bb6-adf2-ada34eca2e7e" alt=""><figcaption><p>The "Floor" widget with 4 connected assets.<br>The connected assets are displayed as green dots at the bottom right.</p></figcaption></figure></div>

{% hint style="warning" %}
**Caution!** The "Floor" widget is designed for use with contact sensors or assets that send values between 0 and 1!

If other assets are linked to the widget, errors can occur.

If you want to display other assets on a floor widget, please create a [-> Custom Widget](/collection/platform/live-cockpit/widgets/custom-widgets.md)
{% endhint %}

## Configure Widget

<figure><img src="https://3489494878-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9GvUpaatBiReR43XFSMg%2Fuploads%2FBCveI3XpNsdxRaew8Tjh%2FStockwerk.png?alt=media&#x26;token=3c4e4f08-b927-4584-9e05-acbaace859f5" alt=""><figcaption></figcaption></figure>

1. Make sure you are in the "Dashboard" menu
2. Click on "Add widget"
3. Click on "View"
4. Click on "Floor"
5. Select the Primary Asset **\[A]**. The name of this asset will appear in the title bar **\[I]** of the widget
6. Optional: Select how much space your new widget should occupy on the dashboard **\[B]**
7. Select the floor that should be displayed in the widget **\[C]**
8. Select the asset that should be displayed in the widget **\[E]**

   ◈ Click on **\[D]** <\<Add current POIs/Polygons>> to add all assets that are placed on the floor. [-> Place assets on a floor](/collection/platform/map-and-floor/floor/placing-assets-on-a-floor.md)
9. Click on "Add widget" **\[H]**

In the **Smart View**, you have the option to switch the display type between **Simple** and **Status**.

* **Simple**: In this view, the positions of the assets and sensors are simply displayed on the floor, without additional status information.
* **Status**: In this view, in addition to the position, you can also see the current **status** of the assets and sensors, such as occupancy, warnings, or other status information.

This switch between views helps to optimize the overview depending on the use case.

<div align="left"><figure><img src="https://3489494878-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9GvUpaatBiReR43XFSMg%2Fuploads%2FWEb1lFnRuFtrH2PG7loq%2Fimage.png?alt=media&#x26;token=6157944f-8c25-41ab-bab6-4e3bf511d2a0" alt="" width="375"><figcaption></figcaption></figure></div>

<figure><img src="https://3489494878-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9GvUpaatBiReR43XFSMg%2Fuploads%2FfXTpL1r3eyZ8T1om1gdt%2FStockwerk%20(2).png?alt=media&#x26;token=7f5742e0-8e0f-48b0-8235-a133c9a4dbbe" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
To make alarms visible in the Floor widget, the alarm switch must be activated in the placed point or polygon [-> Place assets on a floor](/collection/platform/map-and-floor/floor/placing-assets-on-a-floor.md)
{% endhint %}

***

## Operate Widget

<div data-full-width="true"><figure><img src="https://3489494878-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9GvUpaatBiReR43XFSMg%2Fuploads%2FfzeB4jwXbFLdiPSLxNPn%2F58CE095A-5AD3-4648-BDBD-2AAC8F7E9E9F.png?alt=media&#x26;token=2a868e65-2b9a-4d4e-b6d4-76e78a4a5353" alt=""><figcaption></figcaption></figure></div>

<table data-full-width="true"><thead><tr><th width="79.13335164388019"></th><th width="147.5999755859375"></th><th></th></tr></thead><tbody><tr><td><strong>[I]</strong></td><td>Title bar</td><td>The title of the widget. Can be selected under <strong>[A]</strong> during widget configuration.</td></tr><tr><td><strong>[J]</strong></td><td>Icon</td><td>Icon of the widget</td></tr><tr><td><strong>[K]</strong></td><td>Yellow marked asset</td><td>Symbolizes an occupied asset or an asset that sends the value "1".</td></tr><tr><td><strong>[L]</strong></td><td>Green marked asset</td><td>Symbolizes a free asset or an asset that sends the value "0".</td></tr><tr><td><strong>[M]</strong></td><td>More options</td><td>Navigate via widgets</td></tr><tr><td><strong>[N]</strong></td><td>Zoom in</td><td>Enlarge image</td></tr><tr><td><strong>[I]</strong></td><td>Zoom out</td><td>Shrink image</td></tr><tr><td><strong>[I]</strong></td><td>Black marked asset</td><td>Invalid asset. This asset sends an unsupported value.<br>Create a <a href="/pages/SKcko67ZriHkMye9VtPB">-> Custom Widget</a> to display this asset.</td></tr></tbody></table>

## Placement of Assets

In the properties of the individual assets, the placement of the assets can be adjusted.

Learn more about [-> Placing Assets](/collection/mandatory-base/assets/placing-assets-on-a-map.md)

## Customize the Floor Image

The widget displays the floor with the image that is stored in the corresponding floor asset.

You can find out how to assign an image to a floor or change an existing image under [-> Create a floor](/collection/platform/map-and-floor/floor/create-a-floor.md)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.buildings.ability.abb/collection/platform/live-cockpit/widgets/predefined-widgets/floor.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.