> ## Documentation Index
> Fetch the complete documentation index at: https://axiom.co/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Dashboard sections

> This page explains how to organize dashboard elements into collapsible sections.

Sections group related dashboard elements under a shared header. Use sections to divide a large dashboard. Each section expands and collapses independently. When you collapse a section, Axiom stops running queries for the elements inside it. Expand the section to load the elements again.

<Frame caption="Dashboard sections">
  <img src="https://mintcdn.com/axiom/PVFJgne4Ba8fViwe/doc-assets/shots/dashboard-sections.png?fit=max&auto=format&n=PVFJgne4Ba8fViwe&q=85&s=537a37036753d7310abe1a77c21a2019" alt="Dashboard with one expanded section and two collapsed sections" width="3024" height="1726" data-path="doc-assets/shots/dashboard-sections.png" />
</Frame>

## Prerequisites

* [Create an Axiom account](https://app.axiom.co/register).
* [Create an empty dashboard](/docs/dashboards/create).

## Create section

1. Go to the Dashboards tab and open the dashboard where you want to add the section.
2. Click **Edit dashboard**.
3. Click <Icon icon="plus" iconType="regular" /> **Add element** in the top right corner.
4. In **Section**, click **Add section**.
5. Enter a name for the section.
6. Click **Add**.
7. Click **Save dashboard**.

The new section appears below dashboard elements that aren't assigned to a section.

## Add dashboard elements to section

To create a dashboard element directly in a section:

1. Click **Edit dashboard**.
2. In the section header, click <Icon icon="plus" iconType="regular" /> **Add element to section**.
3. Select the type of dashboard element to add.
4. Configure the dashboard element, and then click **Save**.
5. Click **Save dashboard**.

To move an existing dashboard element into a section, enter edit mode and drag the element by its title bar into the section. Drag elements between sections in the same way. To remove an element from a section, drag it to the area above the first section.

Filter bars remain outside sections because they apply to the entire dashboard.

## Expand and collapse section

Click the section header to expand or collapse the section. Collapsing a section stops the queries for its dashboard elements. Expanding the section runs the queries and displays the elements again.

Axiom remembers the expanded or collapsed state for each section in the current browser. This state doesn't change the dashboard for other users.

## Configure section

To configure a section:

1. Click **Edit dashboard**.
2. In the section header, click <Icon icon="ellipsis-vertical" iconType="solid" /> **Section options**.
3. Choose one of the following options:
   * Click **Rename** to change the section name.
   * Click **Collapse by default** to initially display the section as collapsed. Viewers can still expand it.
   * Click **Expand by default** to initially display the section as expanded. Viewers can still collapse it.
4. Click **Save dashboard**.

To change the order of sections, enter edit mode and drag the handle to the left of the section name. Sections always appear below dashboard elements that aren't assigned to a section.

## Delete section

1. Click **Edit dashboard**.
2. In the section header, click <Icon icon="ellipsis-vertical" iconType="solid" /> **Section options**.
3. Choose one of the following options:
   * Click **Delete section, keep charts** to remove the section and move its dashboard elements outside all sections.
   * Click **Delete section and charts** to remove the section and all its dashboard elements from the dashboard.
4. Confirm the deletion.
5. Click **Save dashboard**.

<Warning>
  **Delete section and charts** removes every dashboard element in the section when you save the dashboard.
</Warning>
