Sections

Overview

Sections in Custom Dashboards let you group and organize widgets into logical containers, making dashboards easier to read, manage, and reuse.

With sections, you can:

• Divide a dashboard into meaningful parts based on your monitoring needs.
• Group related widgets for easier viewing and comparison.
• Improve performance by loading data only when a section is expanded.
• Automatically repeat a section for each value of a multi-value variable—ideal for side-by-side comparisons across services, regions, or environments.

What are sections?

Sections let you group related widgets together on a dashboard. You can collapse or expand sections to simplify your layout. Sections are helpful for structuring large dashboards, isolating teams' data, or grouping visualizations by function.

A section can also be set to repeat automatically based on a dashboard variable. This is useful when you want to display the same group of widgets multiple times, once for each selected value of that variable.

Add a section to your dashboard

To add a section:

1. Click +.
2. Drag the Section block into your dashboard layout.
3. Drop widgets into the section. A widget can only belong in one section at a time.

Adjust section controls

Each section is customizable for readability and layout:

• Collapse/expand: Click or toggle across the section header to show or hide the widgets inside. Use this to keep large dashboards easy to scan.
• More actions menu: Use the […] more actions menu in the section header to access the following options:
  • Add repetition: Repeatable sections let you duplicate a group of widgets once for each value of a selected multi-value variable. Each repeated sub-section is automatically scoped to one value.
  • Add description: Add a custom description that appears as a tooltip when hovering over the info icon.
  • Duplicate section: Create a copy of the section and all its widgets.
  • Color picker: Apply a background color to the section to visibly separate it from the other content.
• Widget count: The section header displays how many widgets are in the section.
• Variable chip: For repeated sections, the section header displays a variable chip when a repetitive variable is applied.

Repeat a section by variable

Repeatable sections let you duplicate a group of widgets once for each value of a selected multi-value variable. Each repeated sub-section is automatically scoped to one value.

For instance, a user creates a multi-value variable for subsystems and then runs the following query: coralogix.metadata.subsystemName : ${sub}. Those widgets with variables will be repeated in multiple sub-sections, with one section for every individual value of the variable. If there are three subsystems: adserviceOnly, cartservice, and checkoutservice, then three sub-sections will be recreated, where the widgets present data for a specific service.

Widgets that do not contain the variable in their queries are duplicated into each repeated sub-section without modification.

Set up a repeated section

1. In the more actions menu of a section, click Add repetition.

   

2. Select a multi-value variable from the dropdown.

3. Repeated subsections, one for each value of the multi-value variable, will appear.

Repeated section behavior

• Each subsection is labeled with the variable value it's scoped to.
• Edits to widgets apply across all repeated sub-sections.
• The amount of repeated sub-sections mirrors the number of values for the variable. If the number changes, so does the number of subsections.

Remove repetition

To remove repetition:

1. In the section header, click Remove repetition.
2. The repeated subsections disappear.
3. The original section remains on the dashboard and can be repeated again later.

All repeated sub-sections are removed, and the dashboard reverts to a single section.

Best practices

• Use sections to organize dashboards by team, service, or data type.
• Use repeatable sections for comparing environments, regions, or other categories.
• Only repeat sections by variables that are used inside the section's widgets.
• Keep repeated value counts manageable to preserve dashboard readability.