# Floor Plan The **Floor Plan** widget enables you to display various sensor data on an image that represents objects such as a building floor plan, machine, production line, or any other structure. The image works as a background image and can be a 2D or 3D image in any format. With this widget, you can place **widgets** or **boolean shapes** on the background image to represent the physical sensor locations and display data on them. This approach of visualizing data on the background image offers enhanced insights compared to using standalone widgets. {% hint style="info" %} The Floor plan widget is available on the global dashboards. {% endhint %} In the **Widget options** modal, configure the following: In the **Name** text box, enter a **name** to identify your widget on the dashboard. Click on the **Add floor** button.
In the **Floor name** text box enter a **name** to identify the floor. The provided name will be displayed on the top-left corner of the widget. In the '**Button text'** text box, enter a **name** to display on the button as the button label. The buttons you added are displayed on the bottom-right corner of the widget. You can add a button to each floor. You can navigate to any floor by clicking on the respective button. Click on the **Upload plan** button, then browse and select the **floor plan** (image file) from your computer. {% hint style="info" %} The image file size limit is 300 kB. {% endhint %} Click on the **Save** button. The file will begin uploading.
Once the file has finished uploading, the image will be displayed on the preview workspace.
You can display data on the floor plan (or any background image) using the following boolean shapes and widgets: 1. **Circle** - displays the status in a circle based on whether the measured value is true or false. 2. **Square** - displays the status in a square based on whether the measured value is true or false. 3. **Digital** - a widget that displays measured data for one or more data fields.
### Circle The **Circle** is a boolean shape that allows you to apply different color overlays to the selected area on the floor plan, based on the measured value's condition. If the value is true (`value > 0`), an overlay color is applied, while a different overlay color is used for false (`value <= 0`). Optionally you can display a text alert on the shape based on the current status. In the **Circle options** modal configure the following settings: In the **Circle name** text box, enter a **name** to identify the circle within your floor plan. Click on the **Device Type** drop-down and select the **device type** from the list. Click on the **Device** drop-down (this will list all the devices for the selected device type above) and select the **device** from the list. Click on the **Data field** drop-down and select the **data field** from the list as the data source. In the '**Positive text'** text box, enter the text that you want to display if the measured value is positive. Then click on the **color picker** (next to the 'Positive text') to select a color for the fill color (transparent overlay) of the circle. When the circle receives a 'positive' or 'true' status, it will change to the chosen color. If you haven't chosen a color, the default overlay color will be green. In the '**Negative text'** text box, enter the text that you want to display if the measured value is negative. Then click on the **color picker** (next to the 'Negative text') to select a color for the fill color (transparent overlay) of the circle. When the circle receives a 'negative' or 'false' status, it will change to the chosen color. If you haven't chosen a color, the default overlay color will be red. If you do not want to display the text alert on the shape, turn off the '**Show text**' button. Click on the **Save** button. The **Circle options** modal will close.
Now the circle has been added to the floor plan. Drag and drop the circle onto the floor plan where you want to highlight the area to which the measured status applies. You can resize the circle using its resize points (click on the circle first to show the resize points).
### Square The **Square** is a boolean shape that allows you to apply different color overlays to the selected area on the floor plan, based on the measured value's condition. If the value is true (`value > 0`), an overlay color is applied, while a different overlay color is used for false (`value <= 0`). Optionally you can display a text alert on the shape based on the current status. In the **Square options** modal configure the following settings: In the **Square name** text box, enter a **name** to identify the square within your floor plan. Click on the **Device Type** drop-down and select the **device type** from the list. Click on the **Device** drop-down (this will list all the devices for the selected device type above) and select the **device** from the list. Click on the **Data field** drop-down and select the **data field** from the list as the data source. In the '**Positive text'** text box, enter the text that you want to display if the measured value is positive. Then click on the **color picker** (next to the 'Positive text') to select a color for the fill color (transparent overlay) of the square. When the square receives a positive or true status, it will change to the chosen color. If you haven't chosen a color, the default overlay color will be green. In the '**Negative text'** text box, enter the text that you want to display if the measured value is negative. Then click on the **color picker** (next to the 'Negative text') to select a color for the fill color (transparent overlay) of the square. When the square receives a positive or true status, it will change to the chosen color. If you haven't chosen a color, the default overlay color will be red. If you do not want to display the text alert on the shape, turn off the '**Show text**' button. Click on the **Save** button. The **Square options** modal will close.
Now the square has been added to the floor plan. Drag and drop the square onto the floor plan where you want to highlight the area to which the measured status applies. You can resize the square using its resize points (click on the square first to show the resize points)
### Digital The **Digital** widget allows you to display measured values of up to 2 data fields on a circle. In the **Digital options** modal, configure the following settings: In the **Digital name** text box, enter a **name** to identify the digital widget within your floor plan. In the **Device type** drop-down list, select the **device type**. In the **Device** drop-down list, select the **device** (this will list all the devices for the selected device type above). In the **Data fields** drop-down list, select the **data field** that you want to display the value on the circle (this will list all the data fields for the selected device above).
Click on the **+** button if you want to add the second data field. {% hint style="info" %} If you added 2 data fields, you can remove one of the data fields by clicking on the **x** button. {% endhint %}
Click on the **Save** button. The resulting **Digital** widget will be something like this:
{% hint style="info" %} You can add more floors to the widget by clicking on the **Add floor** button. {% endhint %} After adding all the boolean shapes and widgets onto the floor plan, click on the **Save** button in the **Widget options** modal. The **Floor plan** widget is now added to the dashboard, and it looks something like this: