Edit Dashboards

Creating and managing dashboards is straightforward. A new dashboard can be set up in a few clicks, its appearance customized, and widgets added right away. This page covers everything for creating, editing, and managing dashboards.

To create a new dashboard, use the New Dashboard button in the top-right corner of the screen. A dialog appears with several sections for configuring the dashboard.

The general settings define the basic identity and organization of the dashboard:

• Name - The display name for the dashboard. This name appears in the sidebar and as the dashboard title.
• Description - An optional description providing additional context about the dashboard's purpose.
• Grouping - An optional category used to organize dashboards into collapsible groups in the sidebar. Dashboards sharing the same grouping value are displayed together.

Each dashboard can be given its own visual identity:

• Background Color - An optional custom background color as a hex code, e.g. #ddeeff. Alpha can be used so that a background image shows through.
• Text Color - An optional custom text color as a hex code, e.g. #111111.
• Background Image - An optional background image behind the dashboard grid. Use Select Image to upload or choose an image.

This allows visually distinct dashboards that are easy to recognize at a glance.

This setting is especially relevant when sharing dashboards:

• Displaying Data - Controls whose data the widgets display. The following values are available:
  • The widgets display the data of the respective user - Each viewer sees their own data. Default behavior.
  • The data is provided with my user - All viewers see the dashboard creator's data. Ideal for shared monitoring dashboards.
  • Select user ... - A specific user can be selected whose data is shown to all viewers.

Note: With the last two options, viewers may see data they would not normally have access to.

For more on sharing and access control, see Permissions and Sharing.

Use Save to create the dashboard or Cancel to discard.

Each dashboard uses a flexible grid-based layout. The grid is divided into cells; widgets can span multiple cells horizontally and vertically, allowing precise control over size and position.

When a new dashboard is in edit mode, a grid of placeholder cells with a + icon is shown. To place a widget, draw a rectangular area by dragging across the desired cells. The area is highlighted in blue; releasing the mouse opens the widget selection dialog.

Widgets snap to grid boundaries automatically, so the layout stays clean and organized.

To change a dashboard's layout, use the Edit Widgets pencil icon in the toolbar. The dashboard enters edit mode, indicated by the Finish Editing button with a checkmark.

In edit mode:

• Add new widgets - Click on empty grid cells or draw a rectangular area across multiple cells.
• Move widgets - Drag the widget directly to the desired position.
• Resize widgets - Drag the resize handles at the edges and corners of the widget.
• Edit widget - Click the pencil icon on the widget.
• Copy - Use the copy icon on the widget toolbar. The copied widget can be pasted when adding a new widget; copy also works across windows and, when supported by the target browser, across browsers.
• Delete widget - Click the trash icon and confirm deletion.

On hover, a toolbar appears at the top of each widget with access to widget actions.

Use Finish Editing to exit edit mode.

An existing dashboard can be changed at any time via the gear icon in the toolbar. The settings dialog includes name, description, grouping, appearance, displaying data, permissions, and integrations. Permissions and integrations are not available in the new-dashboard dialog; they are configured in the settings dialog after the dashboard has been created.

Changes are applied with Save. A success message confirms the update.

Dashboards can be exported and imported for backup, migration, or sharing.

To export a dashboard configuration:

1. Open the dashboard to export.
2. In the toolbar's three-dot menu, choose the option to export the dashboard (e.g. Export Dashboard).
3. A .dashboard file is downloaded containing the full dashboard configuration.

Note: Permission settings are not included in the export. After importing, permissions must be configured separately. Whether integrations are included in the export depends on configuration.

There are two ways to import a .dashboard file:

1. Click New Dashboard in the top-right corner and choose Import from its dropdown.
2. Select a previously exported .dashboard file and confirm. A new dashboard is created. You are set as the owner and sharing permissions are reset.

1. Open the dashboard that should receive the imported layout.
2. In the toolbar's three-dot menu, choose Import and Merge.
3. Select a .dashboard file and confirm when prompted. Widget layout and widget settings from the file replace those of the current dashboard. Dashboard name, description, grouping, appearance, Displaying Data, permissions, integrations, and background image stay as they are configured for that dashboard.

Use Import in the dialog to complete the operation after you confirm.