> For the complete documentation index, see [llms.txt](https://docs.buildings.ability.abb/collection/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.buildings.ability.abb/collection/platform/live-cockpit/split-a-dashboard-into-sections.md).

# Split a Dashboard into Sections

Use separators to group dashboard widgets by floor, building, or topic. Collapse a section to focus on the widgets you need.

Each separator spans the full dashboard width. Its section includes the widgets below it, up to the next separator or the end of the dashboard.

## Before You Start

Choose a dashboard you can edit, or [-> create a dashboard](https://docs.buildings.ability.abb/collection/platform/live-cockpit/create-a-new-dashboard.md). See [-> Switch between Dashboards](https://docs.buildings.ability.abb/collection/platform/live-cockpit/switch-between-dashboards.md) to open an existing dashboard. For a [-> public dashboard](https://docs.buildings.ability.abb/collection/platform/live-cockpit/global-dashboards.md), your role needs **Manage** permission for dashboards to add or change separators.

Turn **Masonry** off before moving separators or widgets. See [-> Customize Dashboard Layout](https://docs.buildings.ability.abb/collection/platform/live-cockpit/customize-dashboard-layout.md).

## Section Controls

<div data-full-width="true"><figure><img src="https://2013058394-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOqGnkz52o2zVUsEGEZGk%2Fuploads%2Fgit-blob-c4451726a6eb4d8ec24932eaccb61cdff785b7d7%2Fdashboard-separator-sections.png?alt=media" alt="Dashboard with Monitoring and Operations sections, each containing two link widgets"><figcaption><p>Separators group related widgets on one dashboard.</p></figcaption></figure></div>

<table><thead><tr><th width="90">Element</th><th width="210">Control</th><th>Details</th></tr></thead><tbody><tr><td><strong>[A]</strong></td><td>Live Cockpit</td><td>Open your dashboards.</td></tr><tr><td><strong>[B]</strong></td><td>+ Widget</td><td>Open the widget picker to add a separator or another widget.</td></tr><tr><td><strong>[C]</strong></td><td>Collapse section / Expand section</td><td>Hide or show the widgets in this section. The separator and widget count stay visible. Your choice is remembered in the current browser, not saved in the shared dashboard layout.</td></tr><tr><td><strong>[D]</strong></td><td>Separator title and line</td><td>Drag this area to reposition the separator. Collapse the section first to move it together with its widgets. When the section is expanded, moving the separator moves only the separator.</td></tr><tr><td><strong>[E]</strong></td><td>Widget count</td><td>Show how many widgets belong to the section, including hidden widgets.</td></tr><tr><td><strong>[F]</strong></td><td>Separator actions</td><td><strong>Edit</strong> opens the title settings. <strong>Save</strong> applies your changes. <strong>Remove</strong> deletes the separator but keeps its widgets.</td></tr></tbody></table>

## Add a Separator

<figure><img src="https://2013058394-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOqGnkz52o2zVUsEGEZGk%2Fuploads%2Fgit-blob-4b9cb448b1ad49bf8e3bf01f0f0f95190d28c496%2Fdashboard-separator-configure.png?alt=media" alt="Add Widget: Separator dialog with an optional Monitoring title and a live preview"><figcaption><p>Set an optional title before adding the separator.</p></figcaption></figure>

1. Open your dashboard in **Live Cockpit** **\[A]**.
2. Click **+ Widget** **\[B]**.
3. Select **Separator**.
4. Enter a **Separator title** **\[G]**, such as `Floor 1` or `Monitoring`.\
   ◈ Leave the field empty for a line without a heading. **Preview** **\[H]** updates as you type.
5. Click **Add Widget** **\[I]**.\
   ▷ The separator appears at the end of the dashboard.
6. Drag the separator's title or line **\[D]** to the position where the section should begin.

Add or move widgets below the separator to fill the section. See [-> Add Widgets to the Dashboard](https://docs.buildings.ability.abb/collection/platform/live-cockpit/add-widgets-to-the-dashboard.md).

Separators also work with **Masonry** enabled. Masonry arranges the widgets within each section.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

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

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.buildings.ability.abb/collection/platform/live-cockpit/split-a-dashboard-into-sections.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
