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

# Manage Boards

> Organize panels, control access, and configure display options on your Honeycomb Boards to create consistent views for your team.

export const HnyIcon = ({alias, path, size = 16, iconColor}) => {
  const iconMap = {
    "home": "house.svg",
    "marker": "caretFilledDown.svg",
    "show-marker-options": "chatTextLeft.svg",
    "download": "arrowLineDown.svg",
    "trace-waterfall": "trace.svg",
    "show-query-details": "listDashes.svg",
    "table": "table.svg",
    "log-lines": "logLines.svg",
    "chart": "chartLine.svg",
    "show-settings": "gear.svg",
    "add": "plus.svg",
    "remove": "delete.svg",
    "persist": "caretDown.svg",
    "close": "close.svg",
    "copy": "copy.svg",
    "zoom-in": "magnifyingGlassPlus.svg",
    "zoom-out": "magnifyingGlassMinus.svg",
    "color-assignment": "drop.svg",
    "drag": "dots-six-vertical.svg",
    "drawer": "drawer.svg",
    "show-actions": "dotsThree.svg",
    "edit": "pencil.svg",
    "delete": "trash.svg",
    "move": "arrowsOutCardinal.svg",
    "show-legend": "circleInfo.svg",
    "usage-ok": "usageGood.svg",
    "usage-warning": "usageWarning.svg",
    "usage-danger": "usageDanger.svg",
    "open-query-builder": "query.svg",
    "home-menu": "house.svg",
    "query-menu": "query.svg",
    "boards-menu": "board.svg",
    "triggers-menu": "bell.svg",
    "slos-menu": "handshake.svg",
    "service-map-menu": "serviceMap.svg",
    "history-menu": "clockCounterClockwise.svg",
    "manage-data-menu": "cube.svg",
    "usage-menu": "usageGood.svg",
    "show-details": "dotsThreeVertical.svg",
    "resize-handle": "board-panel-resize-handle.png",
    "standard-dataset": "cube.svg",
    "trace-dataset": "cubeChat.svg",
    "all-datasets": "linkedSquares.svg",
    "share": "arrowBentRight.svg",
    "run-in-query-builder": "arrowSquareUpRight.svg",
    "link": "link.svg",
    "text": "text.svg",
    "receive": "arrowLineDown.svg",
    "process": "lightning.svg",
    "sample": "drop.svg",
    "send": "arrowLineUp.svg",
    "submit": "arrowUp.svg",
    "canvas-menu": "sparkle.svg",
    "canvas": "sparkle.svg",
    "private": "lockKey.svg",
    "shared": "people.svg",
    "expand": "caretDown.svg",
    "previous": "caretLeft.svg",
    "next": "caretRight.svg"
  };
  const iconBasePath = "/_assets/icons/";
  const iconPath = path || (alias ? `${iconBasePath}${iconMap[alias]}` : undefined);
  return <span className="hny-icon" style={{
    display: "inline-block",
    width: `${size}px`,
    height: `${size}px`,
    maskImage: `url(${iconPath})`,
    maskSize: "contain",
    maskRepeat: "no-repeat",
    maskPosition: "center",
    WebkitMaskImage: `url(${iconPath})`,
    WebkitMaskSize: "contain",
    WebkitMaskRepeat: "no-repeat",
    WebkitMaskPosition: "center",
    backgroundColor: iconColor || "var(--hny-icon-color)",
    verticalAlign: "middle"
  }} />;
};

export const CalloutExample = ({children}) => {
  return <Callout icon="clipboard-check" color="#6B7280">
      {children}
    </Callout>;
};

<Info>
  This page reflects the Flexible Boards experience.
  If you are using a legacy Board, [migrate to Flexible Boards](/troubleshoot/product-lifecycle/recommended-migrations/#migrate-to-flexible-boards) to access these features.
</Info>

## Overview

Boards let you organize, display, and control access to your data.
Customize them to create consistent views that help your team collaborate and make informed decisions.

Each level of customization offers unique options to tailor the workspace to your needs:

* **Board**: Manage your workspace's name and sharing settings, ensuring the right team members have access and understand the context of the Board.
* **Query Section**: Customize layout, filter queries, and adjust time settings to group and view queries in a way that highlights the most relevant data.
* **Query Panels**: Fine-tune individual queries by adjusting conditions, captions, and display types to present your data most effectively.

<Note>
  You need appropriate permissions to make changes to a Board.
  To learn more about permission levels, visit [Manage Permissions](/configure/teams/manage-permissions/).
</Note>

## Managing Boards

A Board is a collection of panels and sections, designed to bring together different resources that contribute to a broader investigation.
Manage your Board structure and access to create focused, shareable workspaces that cater to your team's needs.

### Filtering Boards

If your Boards have tags applied to them, you can filter by tags.
This helps you focus on related items.

To filter Boards by tag:

1. Select **Boards** (<HnyIcon alias="boards-menu" />) from the navigation menu.
2. Select the **Filter by tags** field (or the tag area if a default tag is already applied), and choose the tags that you want to filter by.

### Modifying Board Details

Change the name or description of a Board to improve clarity or better align with changes in its use.

<Note>
  By August 29, 2025, any existing query caption will become a part of a query's description.
</Note>

To update a Board's name or description:

1. Select **Boards** (<HnyIcon alias="boards-menu" />) from the navigation menu.
2. Select the Board you want to modify.
3. On the Board's details page, select **Edit** (<HnyIcon alias="edit" />).
4. Hover over the name or description, then select the pencil icon (<HnyIcon alias="edit" />).
5. Make your changes.
6. Select **Done**.

The page refreshes, and the Board updates to reflect your changes.

### Rearranging Panels

Rearrange the panels on your Board to highlight priority data and surface what matters most in your Board's layout.

<Info>
  This functionality is available only for Flexible Boards.

  Learn more about migrating [existing legacy Boards to Flexible Boards](/troubleshoot/product-lifecycle/recommended-migrations/#migrate-to-flexible-boards).

  By August 29, 2025, any remaining legacy Boards will be automatically migrated.
</Info>

To rearrange panels:

1. Select **Boards** (<HnyIcon alias="boards-menu" />) from the navigation menu.
2. Choose the Board containing the panel you want to move.
3. On the Board's details page, select **Edit** (<HnyIcon alias="edit" />).
4. Hover over the panel until the cursor turns into a four-directional arrow (<HnyIcon alias="move" />).
5. Drag and drop the panel to its new location.
6. Select **Done**.

The page refreshes, and the Board updates to reflect your changes.

### Resizing Panels

Resize the panels on your Board to optimize space and improve usability using the flexible Boards experience.

<Info>
  This functionality is available only for Flexible Boards.

  Learn more about migrating [existing legacy Boards to Flexible Boards](/troubleshoot/product-lifecycle/recommended-migrations/#migrate-to-flexible-boards).

  By August 29, 2025, any remaining legacy Boards will be automatically migrated.
</Info>

To resize panels:

1. Select **Boards** (<HnyIcon alias="boards-menu" />) from the navigation menu.
2. Choose the Board containing the panel you want to resize.
3. On the Board's details page, select **Edit** (<HnyIcon alias="edit" />).
4. Hover over the panel resize handle until the cursor turns into a diagonal arrow.
5. Drag the panel edge to the appropriate size.
6. Select **Done**.

The page refreshes, and the Board updates to reflect your changes.

### Changing Access

Boards can be shared with your entire Honeycomb Team or restricted to a subset of your Team members.

By default, Boards are public which means any Team member can access them.
To limit access to yourself or specific teammates, adjust the access level and add collaborators.

<Tip>
  Team owners can always access all Boards owned by their Team members.
  To learn more about permission levels, visit [Manage Permissions](/configure/teams/manage-permissions/).
</Tip>

1. Select **Boards** (<HnyIcon alias="boards-menu" />) from the navigation menu.

2. Choose the Board you want to modify.

3. Select **Share**.

4. Locate the **Who can view and edit this board** dropdown, and choose an option:

   * **Team (All members of environment)**: \[default] Visible to all members of your Honeycomb Team.
   * **Restricted (Collaborators and owners only)**: Only visible to you, Team owners, and invited collaborators. Restricted Boards display a lock next to their name.

5. Confirm your choice:

   * If you chose **Team**, select **Confirm**.
   * If you chose **Restricted**, Honeycomb saves your changes automatically.
     Only you and your Team owner can access the Board.
     To share it with others, [add collaborators](#adding-collaborators).

### Adding Collaborators

Add collaborators to make it easier for your Team to actively contribute and keep your Board relevant.
Collaborators can contribute to a Board by adding or removing panels and by modifying the Board's name and description.

To add collaborators:

1. Select **Boards** (<HnyIcon alias="boards-menu" />) from the navigation menu.
2. Select the Board you want to modify.
3. Select **Share**.
4. In the **Who can view and edit this board** dropdown, make sure **Restricted (Collaborators and owners only)** is selected.
5. In the **Collaborators** section, either:

   * In **Email Address(es)**, enter email addresses of your teammates as needed, then select **Add Collaborator**.
   * Select **Add All Teammates** to add everyone on your team, then remove individual collaborators as needed.

### Removing Collaborators

Keep your Board secure by removing collaborators who no longer need access.

To remove a collaborator:

1. Select **Boards** (<HnyIcon alias="boards-menu" />) from the navigation menu.
2. Choose the Board you want to modify.
3. Select **Share**.
4. Locate the **Who can view and edit this board** dropdown, and make sure **Restricted (Collaborators and owners only)** is chosen.
5. In the **Collaborators** section, find the email address of the collaborator you want to remove, then select **Remove**.

### Leaving a Board

Keep your workspace relevant by leaving Boards you no longer need.
Whether you’re stepping away from a project or no longer monitoring a particular board, removing yourself as a collaborator helps you stay focused.

<Tip>
  If you own the Board, consider [transferring ownership](#transferring-ownership) before leaving.
</Tip>

To leave a Board:

1. Select **Boards** (<HnyIcon alias="boards-menu" />) from the navigation menu.
2. Choose the Board you want to modify.
3. Select **Share**.
4. Locate the **Who can view and edit this board** dropdown, and make sure **Restricted (Collaborators and owners only)** is chosen.
5. Find your email address, then select **Leave**.

### Transferring Ownership

If you are stepping away from a project, delegating responsibilities, or need someone else to manage a Board's settings and permissions, you can transfer administrative control to another Team member.

To transfer ownership:

1. Select **Boards** (<HnyIcon alias="boards-menu" />) from the navigation menu.
2. Choose the Board you want to modify.
3. Select **Share**.
4. Locate the **Who can view and edit this board** dropdown, and make sure **Restricted (Collaborators and owners only)** is chosen.
5. Find the email address of the team member you want to make the owner, then select **Make Owner**.

## Managing the Query Section

The query section of your Board houses the key queries that provide the insights you need.
Manage the query section to control how queries are organized and to improve the overall clarity of this section of your Board.

### Rearranging Query Panels

Reorganize the queries on your Board to prioritize data and improve navigation.

To rearrange query panels:

1. Select **Boards** (<HnyIcon alias="boards-menu" />) from the navigation menu.
2. Choose the Board containing the query you want to move.
3. On the Board's details page, select **Edit** (<HnyIcon alias="edit" />).
4. Hover over the query panel until the cursor turns into a four-directional arrow (<HnyIcon alias="move" />).
5. Drag and drop the query panel to its new location.
6. Select **Done**.

The page refreshes, and the Board updates to reflect your changes.

### Changing Time Range

Adjust the time range for the queries displayed on a Board to analyze specific time periods.
This lets you focus on relevant data, whether it is for troubleshooting or long-term trend analysis.

#### Selecting a Preset Time Range

Preset time ranges offer a quick way to select common time periods for your queries, saving you time when you need to analyze recent or recurring data.

To use a preset time range:

1. Select **Boards** (<HnyIcon alias="boards-menu" />) from the navigation menu.
2. Select the Board that you want to modify.
3. On the Board's details page, locate and open the time picker.
4. Choose a preset time range from the list of common options, such as `Last 10 minutes` or `Last 30 days`.
5. Select **Apply**.

The page refreshes, and your queries update to reflect the selected time range.

#### Defining a Custom Time Range

Choose a custom time range to define a specific time period for your queries, which helps you focus on a precise window of data.

To define a custom time range:

1. Select **Boards** (<HnyIcon alias="boards-menu" />) from the navigation menu.

2. Select the Board that you want to modify.

3. On the Board's details page, locate and open the time picker.

4. Select **Custom**.

5. In the modal, configure your time range:

   | Field               | Description                                                                                                                         |
   | ------------------- | ----------------------------------------------------------------------------------------------------------------------------------- |
   | **Start time**      | Start time for the query time range.                                                                                                |
   | **Relative to now** | Defines how time is specified for the end time: a range relative to the current time \[on], or a fixed date and time in UTC \[off]. |
   | **End time**        | End time for the query time range. For relative time ranges, this is always set to `now`.                                           |

6. Select **Apply**.

The page refreshes, and your queries update to reflect the selected time range.

### Changing Granularity

Granularity controls how Honeycomb groups data over time in your Board's queries, affecting the level of detail shown in charts and tables.

To adjust granularity for query panels:

1. Select **Boards** (<HnyIcon alias="boards-menu" />) from the navigation menu.

2. Select the Board that you want to modify.

3. On the Board's details page, open the time picker and choose **Custom**.

4. In the **Granularity** dropdown, choose the desired time interval.

   <Tip>
     Choose `auto` to let Honeycomb adjust the level of detail automatically based on time range and data volume, balancing performance and clarity.
   </Tip>

5. Select **Apply**.

The page refreshes, and the queries update to reflect the selected granularity.

### Setting Default Time Range & Granularity

You can set default time range and granularity values for a Board, so all of its queries start from a consistent time window and detail level.
Individual queries can still override these defaults when needed.

<Tip>
  If you haven't set explicit defaults, Honeycomb automatically uses the most common time range and granularity settings across the Board's queries.
  To override this behavior, set a new default manually.
</Tip>

To set a default time range and granularity for a Board:

1. Select **Boards** (<HnyIcon alias="boards-menu" />) from the navigation menu.

2. Select the Board for which you want to save defaults.

3. On the Board's details page, select **Edit** (<HnyIcon alias="edit" />).

4. Open the **Set time defaults** dropdown, and choose your preferred time range and granularity options.

   <Tip>
     If any individual queries already have custom time or granularity settings, those values persist unless you select the **Override x custom queries** checkbox (where x represents the number of affected queries).
   </Tip>

5. Select **Apply**.

6. Select **Done** to save defaults to the Board.

The page refreshes, and the queries update to reflect the selected default time range and granularity.

### Filtering Queries

Apply or modify filters on your Board to customize data views and ensure consistent, relevant results.
You can use:

* **Preset filters** (if configured): Define commonly used filters that appear as dropdowns on your Board.
* **Ad-hoc filter expressions**: Enter filter expressions to create custom filters.
* Both

Save filters to the Board to preserve context across sessions, so anyone who views it later will see the filtered results by default.

<CalloutExample>
  If you have a Board called "All Services", which tracks the health of services across your system, you might want to focus only on the health of the frontend service you own.
  In this case, applying the appropriate filter for service name will let you view data on the Board for the frontend service.

  <Frame>
    <img src="https://mintcdn.com/honeycomb/ZEhop91RpDyv3q2S/_assets/images/boards/board-preset-filters.png?fit=max&auto=format&n=ZEhop91RpDyv3q2S&q=85&s=fc1eb8386b033019a9abadb18f1fe18a" alt="Screenshot of the filters area of a Board that has been configured with presets" width="2340" height="412" data-path="_assets/images/boards/board-preset-filters.png" />
  </Frame>
</CalloutExample>

#### Configuring Preset Filters

Preset filters let you define commonly used filters that appear as dropdowns on your Board, making it easier for viewers to filter data without writing filter expressions.
You can add multiple preset filters to help users narrow their view.

To configure preset filters:

1. Select **Boards** (<HnyIcon alias="boards-menu" />) from the navigation menu.
2. Choose the Board to which you want to add preset filters.
3. On the Board's details page, select **Edit** (<HnyIcon alias="edit" />).
4. Select **Add Filter** (<HnyIcon alias="add" />).
5. From the **Property** dropdown, select the field you want to filter by.
6. Enter a **Display name** for the filter.
   This name appears as the label for the filter dropdown.
7. Select **Create filter**.
8. Select **Done** to save your configuration.

The page refreshes, and the Board updates to reflect your configured presets.

#### Removing Preset Filters

To remove a preset filter configuration:

1. Select **Boards** (<HnyIcon alias="boards-menu" />) from the navigation menu.
2. Choose the Board from which you want to remove preset filters.
3. On the Board's details page, select **Edit** (<HnyIcon alias="edit" />).
4. Select the Delete icon (<HnyIcon alias="delete" />) next to the filter display name you want to remove.
5. Select **Done**.

The page refreshes, and the Board updates to reflect your changes.

#### Applying Preset Filters

If your Board has preset filters configured, you can use the filter dropdowns to narrow your data view.

To apply preset filters:

1. Select **Boards** (<HnyIcon alias="boards-menu" />) from the navigation menu.
2. Choose the Board you want to filter.
3. Select a filter dropdown.
4. Choose an operator, and select values.
5. Select **Apply**.

The page refreshes, and the queries update to reflect your changes.

To make preset filter selections persist across sessions, apply your filters and then select **Save Parameters**.
This saves the filter logic as an ad-hoc filter expression.

#### Applying Ad-Hoc Filters

You can enter filter expressions directly in the filter bar to create custom filters.

To apply ad-hoc filters:

1. Select **Boards** (<HnyIcon alias="boards-menu" />) from the navigation menu.
2. Choose the Board you want to filter.
3. On the Board's details page, locate the **Filter by** text box, and select or remove your criteria.

The page refreshes, and the queries update to reflect your changes.

Ad-hoc filters work alongside preset filters.
When you use both types together and select **Save Parameters**, all active filter logic saves as an ad-hoc filter expression.

#### Checking Filter State

Filters apply to all queries on a Board, but because a Board can contain queries from different datasets, filters may not affect every query.

To ensure your data is accurate and consistent, check the filter state for each query.
The filter state can impact your results and how you interpret the data.

To check the applied filters:

1. Select **Boards** (<HnyIcon alias="boards-menu" />) from the navigation menu.
2. Choose the Board you want to review.
3. On each query panel, locate the filter state label next its settings (<HnyIcon alias="show-settings" />).
   The label indicates the filter status.
   Possible statuses include:

   | Status             | Description                                                                                                                                                                       |
   | ------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
   | All                | All filter parameters are successfully applied to the query.                                                                                                                      |
   | No filters applied | No filters are applied because the fields do not exist in the query's dataset.                                                                                                    |
   | Partial            | Some filter parameters are applied, but not all fields exist in the query's dataset. To inspect applied filters, select the Show Details icon (<HnyIcon alias="show-details" />). |

   <Tip>
     If you do not see filter state labels on your query panels, make sure filters are applied to the Board.
     Filter state can only be determined when filter criteria are in place.
   </Tip>

### Managing Views

If you regularly check a Board with the same filter configuration, save it as a named view.
Views preserve your exact filter settings so you can return to the precise context you need with a single click, eliminating the need to rebuild the same scope each time.

#### Saving Views

After [applying filters](/investigate/observe/boards/manage#filtering-queries) to your Board, save them as a named view.

1. Expand (<HnyIcon alias="expand" />) the **View** dropdown, then choose **Save as new**.
2. In the modal, enter a name that describes the filter configuration.
3. Select **Save**.

Your view is now available from the **View** dropdown whenever you return to this Board.

#### Applying Views

Return to a previously saved filter configuration to quickly analyze your Board from a familiar perspective.

To apply a saved view:

1. Select **Boards** (<HnyIcon alias="boards-menu" />) from the navigation menu.
2. Select the Board containing the view.
3. From the **View** dropdown, choose the view you want to apply.

The Board updates to display the saved filter configuration.

#### Renaming Views

Update a view's name to better reflect its purpose or to maintain clarity as your Board's usage evolves.

To rename a view:

1. Select **Boards** (<HnyIcon alias="boards-menu" />) from the navigation menu.
2. Choose the Board containing the view.
3. Expand (<HnyIcon alias="expand" />) the **View** dropdown, then choose **Edit views**.
4. Select the Edit icon (<HnyIcon alias="edit" />) next to the view you want to rename.
5. Modify the name.
6. Select **Save**.

The list of views updates to reflect your changes.

#### Deleting Views

Remove views you no longer need to keep your workspace focused and organized.

To delete a view:

1. Select **Boards** (<HnyIcon alias="boards-menu" />) from the navigation menu.
2. Choose the Board containing the view.
3. Expand (<HnyIcon alias="expand" />) the **View** dropdown, then choose **Edit views**.
4. Select the Remove icon (<HnyIcon alias="remove" />) next to the view you want to remove.
5. Select **Remove**.

The list of views updates to reflect your changes.

## Managing Query Panels

A query panel represents an individual query on your Board.
Modify individual query panels to refine the data and its presentation, so you can focus on the most relevant insights for your investigation.

### Changing Query Conditions

Change query conditions to ensure your data remains aligned with evolving needs.

To modify a query on a Board:

1. Select **Boards** (<HnyIcon alias="boards-menu" />) from the navigation menu.
2. Choose the Board that contains the query you want to modify.
3. On the Board's details page, select the query you want to edit.
4. In the Query Builder, [edit the query](/investigate/query/build/#editing-queries-in-query-builder).
5. Select **Run Query** to apply the changes.
6. Select **Update** to save the modifications.

   <Frame>
     <img src="https://mintcdn.com/honeycomb/ZEhop91RpDyv3q2S/_assets/images/boards/update_topbar.png?fit=max&auto=format&n=ZEhop91RpDyv3q2S&q=85&s=e04ee7c01709e8d12e5e0502d7eb1132" alt="Screenshot of Query Builder display with Update and Save To buttons" width="568" height="66" data-path="_assets/images/boards/update_topbar.png" />
   </Frame>

The page refreshes, and the query panel updates to reflect your changes.

### Changing Query Display

Adjust the display format for individual queries on your Board.

To change the query display:

1. Select **Boards** (<HnyIcon alias="boards-menu" />) from the navigation menu.

2. Select the Board containing the query you want to modify.

3. On the Board's details page, select **Edit** (<HnyIcon alias="edit" />).

4. Locate the target query and select the Show Actions icon (<HnyIcon alias="show-actions" />).

5. Select your preferred display option:

   * **Display Graph only**: Shows only the visualization.
   * **Display Graph & Table**: Displays both the visualization and the summary table.
   * **Display Table Only**: Shows only the summary table.

6. Select **Save**.

The page refreshes, and the query panel updates to reflect your changes.