# Adding and Customizing Layouts

Widgets can be added into layouts that display multiple widgets compacted into one card.

### Adding a Layout

To add a layout, first click the "Add Widget" button on the top of the screen. Then, click the tab that says "Layouts".

![Layout Tab](/files/dpGQMXXOdShr5kuCHQY4)

To drag a layout onto the screen, click the tile for the layout you want to add, and drag it onto the screen.

![Dragging list layout onto the grid](/files/g3VUHwZ9EALwmfL8dGCX)

Just like with regular widgets, a layout can be resized by clicking and dragging the edges of the box.

![Resizing list layout](/files/FrUzbQTqqGrS2gWHg7vY)

### Adding Widgets to Layouts

To add a widget to a layout, simply drag an existing widget over the layout, and when your mouse cursor is hovering over the layout, it will be highlighted yellow. Letting go of your mouse cursor will place the widget into the layout.

![Dragging widget into layout](/files/XlBtO6at13MQGfGZmTxM)

![Widget in layout](/files/lzYNcQXivLh6H7PRnHVo)

Alternatively, you can drag a widget from the "Add Widget" dialog straight into the layout.

![Dragging new widget into layout](/files/UyZQuR7AlTk4RpBY2v5M)

### Moving Widgets Back onto Grid

If you want to remove a widget from a layout and add it back to the grid, simply click and drag the widget out of the layout and back to where you want it on the grid.

![Dragging widget out of layout](/files/S2faLChPphP0z8eXEhcU)

### Deleting Widgets From Layout

If you have a widget in a layout that you want to remove entirely, right click on the layout, then click "Edit Properties".

![Edit Properties Button](/files/9ZrzTFrXshoalCHvjquA)

When you click edit properties, a menu will show up with settings to edit and reorder each element in the layout.

![Edit Properties Menu](/files/CpSBhM0iZPpvLqe6ulBt)

Clicking the trash can button next to the widget will remove that widget from the layout.

### Editing the Order and Properties of Widgets in a Layout

To change the order or properties of a widget in your layout, right click the layout, then click "Edit Properties", which will bring up a menu that looks like this.

![Edit Properties Menu](/files/CpSBhM0iZPpvLqe6ulBt)

To move a widget to a different spot in the layout, click and drag the handle on the right.

![Changing Order](/files/qzJaXZAZOUhxybgHKPst)

To change the properties of a widget that is in your layout, click the arrow on the left side of the tile for the widget. Doing so will reveal the editable properties of that specific widget.

![Widget Edit Properties](/files/sYJOP39JqChSP6UYBWoG)

### Adding Gyro (Example)

This gif is an example of how to add a layout. This adds a list layout and puts info about the gyro sensor in it, along with demonstrating how to change the settings.

![Adding Gyro Example](/files/zhuXDe8nauihW3tEBYDy)


---

# 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://frc-elastic.gitbook.io/docs/customizing-your-dashboard/adding-and-customizing-layouts.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.