# Add a widget to a dashboard

> For the complete documentation index, see [llms.txt](https://docs.oriondata.io/llms.txt)

Add a tile, select its visualisation and sensor series, then save it to a dashboard.

For a full explanation of each tile configuration field and the available tile styles, see [Chart tile settings](https://docs.oriondata.io/portal/dashboards/how-to-configure-a-chart-widget/).

## Before you begin

You will need access to an existing dashboard and a role that permits editing. If you do not have edit access, contact your administrator.

## Adding a new tile

1. Open the dashboard you want to edit.
2. Select the **+** button in the dashboard toolbar.

![Dashboard toolbar with the add tile button highlighted next to the dashboard title](https://docs.oriondata.io/images/portal/dashboards/how-to-add-a-widget-to-a-dashboard/dashboard-toolbar-add-tile-button-next-dashboard-title.png)

The **Edit Tile** panel will open on the right side of the screen.

## Configuring the tile

![Edit Tile panel with Tile Name, Tile Color, Has Custom Relative Date, Tile Style icons, Axis Options and Series](https://docs.oriondata.io/images/portal/dashboards/how-to-add-a-widget-to-a-dashboard/edit-tile-panel-tile-name-tile-color-has-custom-relative-date-tile-style-icons.png)

1. Enter a name in the **Tile Name** field. This appears as the header on the tile.
2. Select a colour using the **Tile Color** picker if required.
3. If this tile needs to display a different time period from the rest of the dashboard, enable the **Has Custom Relative Date** toggle and set the desired range.
4. Select a visualisation style from the **Tile Style** selector.
5. Adjust the **Axis Options** if required. For most tiles, the default **Auto** scaling is sufficient.

## Adding a series to the tile

A tile must have at least one series assigned to display data. Multiple series can be added to a single tile, including data from different devices.

1. In the **Series** section, select the device you want to use as the data source. The device tag will appear once selected.
2. Use the **Select Series** dropdown to choose the specific sensor channel to display.
3. Enter a **Label** for the series as it will appear in the tile legend.
4. Assign the series to a Y axis and select a colour for the series.
5. To add another series, repeat the preceding device, channel, label and axis selections.

![Edit Tile Axis Options and Series, with a Rainfall series from a selected device assigned to the Y axis with a colour](https://docs.oriondata.io/images/portal/dashboards/how-to-add-a-widget-to-a-dashboard/edit-tile-axis-options-series-rainfall-series-from-selected-device-assigned-y.png)

## Saving the tile

1. Once the tile is configured, select **Save Tile** to add it to the dashboard canvas.

![Dashboard toolbar with the Save Dashboard button highlighted](https://docs.oriondata.io/images/portal/dashboards/how-to-add-a-widget-to-a-dashboard/dashboard-toolbar-save-dashboard-button.png)

## Arranging tiles on the canvas

After saving, the tile will appear on the dashboard canvas. You can reposition and resize it to suit your layout.

- To move a tile, select and drag it to the desired position on the canvas.
- To resize a tile, drag the edges or corners of the tile.

## Editing an existing tile

To make changes to a tile that has already been added:

1. Select the tile you want to edit on the dashboard canvas.
2. The **Edit Tile** panel will open with the current configuration loaded.
3. Make the required changes and select **Save Tile** to apply them.

## Deleting a tile

To remove a tile from the dashboard:

1. Click the **Tile** panel for the tile you want to remove.
2. Go to the top right of the panel and select **Delete tile**.

![Tile toolbar with the delete tile icon highlighted](https://docs.oriondata.io/images/portal/dashboards/how-to-add-a-widget-to-a-dashboard/tile-toolbar-delete-tile-icon.png)

The tile will be removed from the dashboard canvas immediately.

## Summary

Tiles are added to a dashboard using the **+** button in the toolbar, configured using the **Edit Tile** panel, and saved with **Save Tile**. Once on the canvas, tiles can be repositioned and resized freely. Existing tiles can be edited or deleted at any time by opening the **Edit Tile** panel for that tile.

## Next Steps

- Add the **Date Filter Options** to control the time period shown across your dashboard tiles
- Review [Chart tile settings](https://docs.oriondata.io/portal/dashboards/how-to-configure-a-chart-widget/) for chart settings
- Arrange your tiles into a layout that suits your monitoring workflow