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

# Slicer widget

> Configure Building BI slicers by column type, display mode, and interaction rules.

A slicer is an on-canvas filter bound to a **single column**. Viewers change the selection; widgets in scope re-query. Configure one from [Dashboard filters](/products/building-bi/dashboards#dashboard-filters). For operators and scope, see [Filter options](/products/building-bi/reference/filter-options).

## Setup

| Field   | Description                                                                             |
| ------- | --------------------------------------------------------------------------------------- |
| Filter  | Required. One column. String columns load distinct values; number columns load min/max. |
| Sort    | Optional ascending or descending order.                                                 |
| Filters | Optional chart-level filters, as on any widget.                                         |

A slicer cannot be a metric filter.

## Behavior by column type

| Column type | Operator                          | Selection       | Notes                                          |
| ----------- | --------------------------------- | --------------- | ---------------------------------------------- |
| String      | `IN`                              | Single or multi | Multi can include Select All                   |
| Boolean     | `EQUALS`                          | Single only     | Not affected by other slicers or cross-filters |
| Number      | `BETWEEN`                         | Min/max range   | Bounds load with the widget                    |
| Date / Time | Current, Previous, Last, Specific | Per type        | See date table                                 |

## Display options

| Property | Options                                                         |
| -------- | --------------------------------------------------------------- |
| String   | Dropdown or Flat; Single or Multi                               |
| Boolean  | Dropdown or Flat (tiles)                                        |
| Date     | Specific, Last, Previous, or Current — each as Dropdown or Flat |
| Values   | Font styling; row padding when Flat                             |
| General  | Same general style options as other widgets                     |

### Date defaults

| Type               | Default       |   Dropdown   |     Flat     |
| ------------------ | ------------- | :----------: | :----------: |
| Specific           | Other date    |      Yes     |      Yes     |
| Last Date/Time     | Last 7 days   | Yes (single) | Yes (single) |
| Previous Date/Time | Previous Week | Yes (single) | Yes (single) |
| Current Date/Time  | Current Week  | Yes (single) | Yes (single) |

## Interaction rules

* Selections saved in edit mode become the published defaults.
* Dashboard filters, page filters, and cross-filters affect slicers.
* Boolean slicers ignore other slicers and cross-filters.
* Apply on selection, or behind an **Apply** button.

## Next steps

<CardGroup cols={2}>
  <Card title="Filter options" icon="list-filter" href="/products/building-bi/reference/filter-options" arrow={true}>
    Look up operators and filter scopes.
  </Card>

  <Card title="Chart types" icon="bar-chart-3" href="/products/building-bi/reference/chart-types" arrow={true}>
    Find the slicer in the widget catalogue.
  </Card>
</CardGroup>