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

# Configuring filter display options in advanced dashboards

> Customize how filters appear on advanced layout dashboards with button toggles, multi-select dropdowns, single-day pickers, and timeframe controls.

export const feature_is_0 = "Advanced filter display options are"

export const DashboardCatalogIcon = ({label}) => {
  return <span>
      <svg stroke="currentColor" fill="none" stroke-width="2" viewBox="0 0 24 24" stroke-linecap="round" stroke-linejoin="round" height="1em" width="1em" xmlns="http://www.w3.org/2000/svg" style={{
    display: "inline",
    verticalAlign: "middle"
  }}><path d="M10 19h-6a1 1 0 0 1 -1 -1v-14a1 1 0 0 1 1 -1h6a2 2 0 0 1 2 2a2 2 0 0 1 2 -2h6a1 1 0 0 1 1 1v14a1 1 0 0 1 -1 1h-6a2 2 0 0 0 -2 2a2 2 0 0 0 -2 -2z"></path><path d="M12 5v16"></path><path d="M7 7h1"></path><path d="M7 11h1"></path><path d="M16 7h1"></path><path d="M16 11h1"></path><path d="M16 15h1"></path></svg>
      {label && ` ${label}`}
    </span>;
};

<Note>
  {feature_is_0} a feature of [advanced dashboard layouts](/visualize-present/dashboards/advanced-layout).
</Note>

Advanced layout dashboards support additional ways to display filters beyond the standard [dashboard filter](/visualize-present/dashboards/filters) dropdown. Choose how each filter appears to viewers — as a row of button toggles, a multi-select dropdown, a single-day calendar, or a timeframe picker — to match the way they need to interact with your data.

## Requirements

To follow this guide, you'll need:

* **A dashboard using advanced layouts**. See [Enabling advanced layout](/visualize-present/dashboards/advanced-layout#enabling-advanced-layout) for more information.
* Content permissions that allow you to edit dashboards

## Working with string filters

<Note>
  This only applies to **string** filters.
</Note>

String filters can be displayed in a few ways, including:

* [Buttons](#select-buttons), for both single and multiple selections
* [Dropdown list (multi-select)](#multi-value-dropdown)

<h3 id="select-buttons">
  Displaying options as buttons
</h3>

<Note>
  Filters must be placed inside a [container](/visualize-present/dashboards/containers-items) to use this display option.
</Note>

String filter values can be displayed as a row of buttons that users can click to select. This provides a more visual, accessible way to switch between options.

Button options can be displayed in two ways:

<Columns cols={2}>
  <Card title="Inline" img="https://mintcdn.com/omni-e7402367/B_sd3Nzmk7NEgZCA/visualize-present/images/advanced-filter-single-toggle.png?fit=max&auto=format&n=B_sd3Nzmk7NEgZCA&q=85&s=a986f5d2de499da5aba292359d4b12dd" width="389" height="117" data-path="visualize-present/images/advanced-filter-single-toggle.png">
    Displays inline with the dashboard content
  </Card>

  <Card title="Popover" img="https://mintcdn.com/omni-e7402367/B_sd3Nzmk7NEgZCA/visualize-present/images/advanced-filter-single-popover.png?fit=max&auto=format&n=B_sd3Nzmk7NEgZCA&q=85&s=744605ee1c43aca2d7c251c1093adfe9" width="350" height="117" data-path="visualize-present/images/advanced-filter-single-popover.png">
    Opens in an overlay when clicked
  </Card>
</Columns>

When a filter option is clicked, the queries connected to the filter will update.

By default, up to the first 50 values for the filter column are used as options. You can customize which values are included using the **Values** setting described below. Button options work best with a small number of choices, typically between two and seven.

To configure a string filter to display as buttons:

<Steps>
  <Step title="Add and configure the filter">
    1. Open a dashboard and enter draft mode by clicking **Edit**.
    2. Click **Add > Filter** to add a new filter.
    3. Configure the filter, clicking **Done** when finished.
  </Step>

  <Step title="Move the filter into a container">
    Next, you'll move the filter into a dashboard [container][containers-items]. This is required to access the filter's single selection options.

    1. At the top of the dashboard, click <DashboardCatalogIcon /> **Catalog**, then the filter. This will open the filter's properties panel on the right side of the page.
    2. In the filter properties panel, click **Move**.
    3. In the dropdown, select the container you want to move the filter to:

           <img src="https://mintcdn.com/omni-e7402367/B_sd3Nzmk7NEgZCA/visualize-present/images/advanced-property-panel-move.png?fit=max&auto=format&n=B_sd3Nzmk7NEgZCA&q=85&s=b8e384b62c4c8e66672d1f889e39fac9" alt="The filter properties panel with the Move dropdown open, showing available containers" width="416" height="240" data-path="visualize-present/images/advanced-property-panel-move.png" />
  </Step>

  <Step title="Configure selection options">
    1. If the filter properties panel is no longer open, click the filter to open it.
    2. Configure the following fields:

       * **Filter type** - Select **Single selection** or **Multiple selection**
       * **Filter control** - Set to **Button toggle**
       * **Filter display** - Select **Inline** or **Popover**
       * **Values** - Define the options you want to include in the filter display:
         * **All values** - **Default**. Up to the first 50 values for the filter column will display.
         * **Select exact values** - Choose specific values to include. After selecting this option, a value picker will appear where you can check the values you want.
  </Step>
</Steps>

<h3 id="multi-select-button-group">
  Displaying multiple selection options as buttons
</h3>

<Note>
  Filters must be placed inside a [container](/visualize-present/dashboards/containers-items) to use this display option.
</Note>

Multiple selection string filters can be displayed as a row of buttons that users can click to select. This provides a visual alternative to the multi-value dropdown, allowing users to see and select multiple filter values using button toggles.

Multiple selection button options can be displayed in two ways:

<Columns cols={2}>
  <Card title="Inline" img="https://mintcdn.com/omni-e7402367/B_sd3Nzmk7NEgZCA/visualize-present/images/advanced-filter-single-toggle.png?fit=max&auto=format&n=B_sd3Nzmk7NEgZCA&q=85&s=a986f5d2de499da5aba292359d4b12dd" width="389" height="117" data-path="visualize-present/images/advanced-filter-single-toggle.png">
    Displays inline with the dashboard content
  </Card>

  <Card title="Popover" img="https://mintcdn.com/omni-e7402367/B_sd3Nzmk7NEgZCA/visualize-present/images/advanced-filter-single-popover.png?fit=max&auto=format&n=B_sd3Nzmk7NEgZCA&q=85&s=744605ee1c43aca2d7c251c1093adfe9" width="350" height="117" data-path="visualize-present/images/advanced-filter-single-popover.png">
    Opens in an overlay when clicked
  </Card>
</Columns>

When filter options are clicked, the queries connected to the filter will update to include all selected values.

By default, up to the first 50 values for the filter column are used as options. You can customize which values are included using the **Values** setting described below. Button options work best with a small number of choices, typically between two and seven.

To configure a string filter for multiple selection with buttons:

<Steps>
  <Step title="Add and configure the filter">
    1. Open a dashboard and enter draft mode by clicking **Edit**.
    2. Click **Add > Filter** to add a new filter.
    3. Configure the filter, clicking **Done** when finished.
  </Step>

  <Step title="Move the filter into a container">
    Next, you'll move the filter into a dashboard [container][containers-items]. This is required to access the filter's button group options.

    1. At the top of the dashboard, click <DashboardCatalogIcon /> **Catalog**, then the filter. This will open the filter's properties panel on the right side of the page.
    2. In the filter properties panel, click **Move**.
    3. In the dropdown, select the container you want to move the filter to:

           <img src="https://mintcdn.com/omni-e7402367/B_sd3Nzmk7NEgZCA/visualize-present/images/advanced-property-panel-move.png?fit=max&auto=format&n=B_sd3Nzmk7NEgZCA&q=85&s=b8e384b62c4c8e66672d1f889e39fac9" alt="The filter properties panel with the Move dropdown open, showing available containers" width="416" height="240" data-path="visualize-present/images/advanced-property-panel-move.png" />
  </Step>

  <Step title="Configure multiple selection button options">
    1. If the filter properties panel is no longer open, click the filter to open it.
    2. Configure the following fields:

       * **Filter type** - Set to **Multiple selection**
       * **Filter control** - Set to **Button group**
       * **Filter display** - Select **Inline** or **Popover**
       * **Values** - Define the options you want to include in the filter display:
         * **All values** - **Default**. Up to the first 50 values for the filter column will display.
         * **Select exact values** - Choose specific values to include. After selecting this option, a value picker will appear where you can check the values you want.
  </Step>
</Steps>

<h3 id="multi-value-dropdown">
  Displaying multiple selection options as dropdowns
</h3>

String filters can be configured to allow multiple value selection using a dropdown interface. This allows users to select several options at once, allowing viewers to filter data across multiple categories at once.

<img src="https://mintcdn.com/omni-e7402367/tY7GCGn8-V6j7AEF/visualize-present/images/advanced-filters-multi-select.png?fit=max&auto=format&n=tY7GCGn8-V6j7AEF&q=85&s=59b64d20b3adc6810aa315d443b8a52d" style={{width: "450px", height: "auto"}} alt="Multiple selection filter with country options" width="448" height="347" data-path="visualize-present/images/advanced-filters-multi-select.png" />

Multiple selection dropdowns display inline with the dashboard content and provide a clear view of all selected values.

To configure a string filter for multiple selection:

<Steps>
  <Step title="Add and configure the filter">
    1. Open a dashboard and enter draft mode by clicking **Edit**.
    2. Click **Add > Filter** to add a new filter.
    3. Configure the filter, clicking **Done** when finished.
  </Step>

  <Step title="Configure multiple selection options">
    1. If the filter properties panel is no longer open, click the filter to open it.
    2. Configure the following fields:

       * **Filter type** - Set to **Multiple selection**
       * **Filter control** - Set to **Dropdown**. This is currently the only supported control type for multiple selection.
       * The filter will automatically display inline with your dashboard content.
  </Step>
</Steps>

## Working with date filters

<Note>
  This section only applies to **date** filters.
</Note>

Date filters can be displayed as a full range picker, a single-day calendar, or a timeframe control with preset options like "Last 7 days." Choose the interface that matches how viewers need to interact with dates in your dashboard.

### Selecting a date filter interface

When working with date filters, you can choose how the filter interface appears to users. First create the filter, then use the **Filter type** setting to choose a display option:

#### Default

The standard date filter interface with range selection and preset options:

<Frame caption="**Default (advanced) date filter**">
  <img src="https://mintcdn.com/omni-e7402367/swk7Gm-6hqGAZcjK/visualize-present/images/advanced-filters-date-default.png?fit=max&auto=format&n=swk7Gm-6hqGAZcjK&q=85&s=e1331bbf488a33e0c1cb963f0bd4ced5" alt="Default (advanced) date filter with range selection and options" width="440" height="272" data-path="visualize-present/images/advanced-filters-date-default.png" />
</Frame>

#### Single day

A simplified calendar interface that allows users to select a specific day. This is useful when you want to focus dashboard viewers on analyzing data for one date at a time, such as daily reports or date-specific snapshots.

<Frame caption="**Single day date filter**">
  <img src="https://mintcdn.com/omni-e7402367/swk7Gm-6hqGAZcjK/visualize-present/images/advanced-filters-date-single-day.png?fit=max&auto=format&n=swk7Gm-6hqGAZcjK&q=85&s=2b3278ab158a964d267a2be38903efa2" alt="Single day date filter" width="340" height="489" data-path="visualize-present/images/advanced-filters-date-single-day.png" />
</Frame>

<h3 id="timeframe-filter-control">
  Configuring timeframe selection
</h3>

The timeframe filter control provides a user-friendly way to filter data by common time periods. Instead of selecting exact dates, users can choose from preset options like "Last 7 days" or "Last 30 days," and optionally define custom date ranges when needed.

This control is useful when your dashboard viewers need to quickly switch between common time windows without navigating a full date picker interface.

To configure a date filter to use the timeframe control:

<Steps>
  <Step title="Add and configure the filter">
    1. Open a dashboard and enter draft mode by clicking **Edit**.
    2. Click **Add > Filter** to add a new filter.
    3. Configure the filter with a date field, clicking **Done** when finished.
  </Step>

  <Step title="Set the filter control type">
    1. If the filter properties panel is no longer open, click the filter to open it.
    2. Set **Filter control** to **Timeframe**.
  </Step>

  <Step title="Select preset options">
    Choose which timeframe options to make available to users. You can select from Omni's preset options or create custom timeframes. The selected options will appear as choices in the filter control.
  </Step>

  <Step title="Enable custom timeframe (optional)">
    Toggle **Allow custom timeframe** to let users define their own date range when the preset options don't meet their needs.

    When enabled, a custom option appears in the filter. Selecting it will open a custom date range picker.
  </Step>
</Steps>

## Next steps

* Learn to [build dashboard layouts][containers-items] with containers and items like charts, text, filters, and controls.
* Use [pages](/visualize-present/dashboards/pages) to create multi-page dashboards, where each page has its own layout, items, and filters.
* Customize [page navigation](/visualize-present/dashboards/page-navigation) to control how viewers move between pages, including custom tabs and dynamic labels.

[containers-items]: /visualize-present/dashboards/containers-items
