# Basic Slicer Plume: every field and setting explained

> Every field well and every Format pane setting in Basic Slicer Plume: what it's for, the values it accepts and its default value, card by card, in order.

- Language: English
- Web page: https://plumevisuals.com/en/tutorials/basic-slicer-plume-champs-et-reglages
- Published: 2026-10-14
- Visual: Basic Slicer Plume, technical reference: https://plumevisuals.com/ai/visuals/basic-slicer.md
- If an option name in this tutorial differs from the technical reference, the reference is right (it is generated from the visual's code).

This page describes everything Basic Slicer Plume offers: the field wells, then each card in the Format pane, in the order they appear. Each setting's default value is in **bold**, and premium features are marked with a ★. For a first guided visual, see [getting started](/en/tutorials/segment-menu-deroulant-hierarchie).

## The visual's fields

| Field (exact name) | Required? | How many fields | What to drop in | What it does | Example |
|---|---|---|---|---|---|
| **Field (or hierarchy levels)** | Yes | 1 to 6 | Columns (text, number, Boolean, date) | The values in the menu; several columns form a hierarchy. This is what the filter applies to. | `Category`, then `Product` |
| **Count (optional)** | No | 1 | An additive measure | Number shown to the right of each value, sorting by count, detection of values without data | `Order Count` |
| **Preselection** | No | 1 | A measure that returns text | Values selected when the report opens ★ | `Preselected Products` |
| **Dynamic format** | No | Several | Measures named `card.setting` | Drive a Format pane setting with DAX | — |

**Field (or hierarchy levels).** One column gives a simple list. Several columns do **not** give several menus side by side (for that, use Filter Bar Plume) but a **tree**: the first column is the top level, the next one goes underneath it, and so on. Checking a parent checks all its children; a half-filled checkbox means only some of the children are checked. 1 or 2 levels are free; 3 to 6 levels are a ★ feature. The **Hierarchy** card in the Format pane only appears from 2 levels on.

**Count (optional).** A single measure. A parent shows the sum of its children: a non-additive measure would give wrong totals. Without a count, the menu works but shows no numbers, sorting by count is meaningless, and values without data aren't detected.

**Preselection.** A measure that returns, as text, the value or values to check when the report opens, separated by `;` ("Lighting;Garden"). The visual looks for them in every level, the first one first; "Parent › Value" targets a specific node when the same label exists under several parents. The comparison ignores case, accents and spaces. Settings: **Preselection** card; premium feature ★, details in [the shared basics](/en/tutorials/bien-demarrer-visuels-plume).

This visual has no **Tooltips** well. **Dynamic format**: see [the shared basics](/en/tutorials/bien-demarrer-visuels-plume).

## Format pane settings

### Header

The title shown above the box or the list.

| Setting | What it does | Options (default in **bold**) |
|---|---|---|
| Show | Shows or hides the header row (card toggle). | **On** / Off |
| Text | Title text. Empty: the field name, or "Level 1 › Level 2" for a hierarchy. | Free text (**empty**) |
| Size | Title size, in points. | 7 to 36 (**13**) |
| Bold | Makes the title bold. | **On** / Off |
| Italic | Makes the title italic. | On / **Off** |
| Underline | Underlines the title. | On / **Off** |
| Color (empty = text) | Title color. Empty: the style's text color. | Color (**empty**) |
| Background color | Fills the header row's background, like the native title background. | Color (**empty**) |
| Horizontal alignment | Puts the title on the left, in the center or on the right. When centered, the title stays in the middle even with the counter and the Clear button. | ***Left*** / *Center* / *Right* |
| Text wrap | A long title goes on two lines (breaking between words) instead of being cut with "…". | **On** / Off |
| Show divider | Draws a line under the header. | On / **Off** |
| Color (empty = lines) (appears if Show divider is on) | Line color. Empty: the style's line color. | Color (**empty**) |
| Line style (appears if Show divider is on) | Line pattern. | ***Solid*** / *Dashed* / *Dotted* |
| Width (appears if Show divider is on) | Line thickness, in pixels. | 1 to 6 (**1**) |
| Show value / selection count | Shows the number of selected values in the header. No effect with *Dropdown*. | On / **Off** |
| "Clear" button | Shows a button in the header that clears the selection, visible when something is checked. No effect with *Dropdown* (in a dropdown, the × is in the box). | **On** / Off |
| Clear button label (appears if "Clear" button is on) | Replaces the button text. | Free text (**empty** = "Clear") |

### Layout

The form of the slicer (dropdown, list or tile buttons), then the settings for the menu, the collapsed box and the tiles.

| Setting | What it does | Options (default in **bold**) |
|---|---|---|
| Style | *Dropdown*: a one-line box whose list opens when clicked. *Vertical list*: the values stay displayed in the frame, like the native slicer's list, and scroll if needed. *Tile*: one button per value, side by side, like the native slicer's Tile style (one level only). | ***Dropdown*** / *Vertical list* / *Tile* |
| Menu opening (appears if Style = *Dropdown*) | *Auto*: below the box if at least 120 px are left in the frame, otherwise as a full-frame panel with a close button. *Below the box*: always below the box. *Full frame*: always as a panel taking up the whole frame. | ***Auto*** / *Below the box* / *Full frame* |
| Maximum menu height (px) (appears if Menu opening = *Auto* or *Below the box*) | Height beyond which the menu scrolls. | 80 to 1200 (**300**) |
| Menu width (px, 0 = box) (appears if Menu opening = *Auto* or *Below the box*) | Width of the open menu. 0: the width of the box. | 0 to 1200 (**0**) |
| Box height (px) (appears if Style = *Dropdown*) | Height of the closed box. | 24 to 64 (**32**) |
| Text when nothing is selected (appears if Style = *Dropdown*) | Text shown in the box when nothing is checked. | Free text (**empty** = "All") |
| Selection display (appears if Style = *Dropdown*) | What the box shows when values are checked: their names, cut off with "+n", or how many there are. | ***Selected values (+n)*** / *Count (3 selected)* |
| Clear (×) button (appears if Style = *Dropdown*) | Shows a × in the box that clears the selection. | **On** / Off |
| Columns (0 = fit the width) (appears if Style = *Tile*) | Number of button columns. 0: as many as the frame's width allows. | 0 to 12 (**0**) |
| Fixed button height (px, 0 = auto) (appears if Style = *Tile*) | Gives every button the same height, like the native slicer's "Fixed size"; a scroll bar appears if needed. 0: automatic height. | 0 to 200 (**0**) |

> **Tip:** **Tip**: a Power BI visual can't draw outside its frame. So the menu opens **inside** the Basic Slicer Plume frame: making that frame taller toward the bottom (steps 8 to 10 of the walkthrough) is what lets it go over the visual below.


### Selection

How a click picks values.

| Setting | What it does | Options (default in **bold**) |
|---|---|---|
| Mode | *Multiple (click = toggle)*: each click checks or unchecks. *Multiple with Ctrl*: a simple click replaces the selection, Ctrl + click adds. *Single value*: radio buttons, and choosing a value closes the menu. | ***Multiple (click = toggle)*** / *Multiple with Ctrl* / *Single value* |
| Indicator | The marker in front of each value. *Automatic* adapts it to the mode; *None (highlight)* keeps only the tinted background. | ***Automatic*** / *Checkbox* / *Radio button* / *None (highlight)* |
| Always keep one value selected (appears if Mode = *Single value*) | Prevents unchecking everything: no ×, no Clear button and no Delete key are offered. | On / **Off** |
| "Select all" row (appears if Mode = *Multiple (click = toggle)* or *Multiple with Ctrl*) | Adds a row at the top of the menu that checks or unchecks everything. | On / **Off** |
| "Select all" label (appears if "Select all" row is on) | Replaces the text of this row. | Free text (**empty**) |
| Move selection to the top | Places checked values at the top of the menu. | On / **Off** |

With the keyboard: **Enter**, **Space** or ↓ opens the menu; ↑ ↓ to move; → expands (or goes to the first child); ← collapses (or goes back up to the parent); **Space** or **Enter** checks; Home / End; **Esc** closes the menu and returns focus to the box; **Delete** clears the selection. In the *List* layout, **Tab** goes straight to the values. Right-clicking a value opens the Power BI context menu.


### Hierarchy

How the tree behaves. This card only appears with at least 2 columns in **Field (or hierarchy levels)**.

| Setting | What it does | Options (default in **bold**) |
|---|---|---|
| Levels expanded on open | Number of levels already expanded when the menu opens. 0: only the top-level categories are visible. | 0 to 5 (**0**) |
| Expand all / Collapse all buttons | Adds two buttons above the values. | On / **Off** |
| Indent per level (px) | How far each level is shifted to the right. | 0 to 40 (**16**) |
| Child count on parents | Shows "(n)" next to each parent: its number of children. | On / **Off** |
| Parent in the box (Parent › Value) (appears if Style = *Dropdown*) | Writes "Decor › Vase" in the closed box instead of "Vase". | On / **Off** |
| Restrict to leaf nodes | Like the native list slicer: parents expand but can't be selected; only the values of the last level can be checked. | On / **Off** |

### Values

The order, the count and the look of the values.

| Setting | What it does | Options (default in **bold**) |
|---|---|---|
| Sort | Order of the values. *Model order* follows the order of the data or the sort column defined in the model. Sorting by count uses the **Count (optional)** measure. | ***Model order*** / *Label A → Z* / *Label Z → A* / *Count, descending* / *Count, ascending* |
| Natural sort (2 before 10) | Sorts numbers inside labels as numbers: "M2" before "M10". | **On** / Off |
| Show the count | Shows the count measure to the right of the values. | **On** / Off |
| Display units (appears if Show the count is on) | Abbreviates large numbers. | ***Auto*** / *None* / *Thousands* / *Millions* / *Billions* |
| Decimals (-1 = auto) (appears if Show the count is on) | Number of digits after the decimal point for the count; -1 lets the visual choose. | -1 to 6 (**-1**) |
| Values without data | What to do with values that no longer have data under the current filters. Requires a measure in **Count (optional)** and **Show items with no data** on the field. | ***Grouped at the bottom, dimmed*** / *In place, dimmed* / *Hidden* |
| Blank label | Text shown for a column's blank value (cells with no content). | Free text (**empty**) |
| Wrap labels | Lets long labels wrap onto the next line. | On / **Off** |
| Separators | Draws a thin line between values. | On / **Off** |
| Tinted background when selected | Colors the background of checked values. | **On** / Off |

### Search

A search box at the top of the menu. It ignores accents and capitalization; in a hierarchy, the values found are shown with their parents expanded.

| Setting | What it does | Options (default in **bold**) |
|---|---|---|
| Show | Shows or hides the search box (card toggle). | On / **Off** |
| Placeholder | Grayed-out text shown in the empty box. | Free text (**empty**) |
| Matching | *Contains*: the text can be anywhere. *Starts with*: the value must start with the text. *Word start*: one of the words must start with the text. | ***Contains*** / *Starts with* / *Word start* |
| Highlight matches | Highlights the typed text in the results. | **On** / Off |

### Preselection

Selects values when the report opens: drop into the **Preselection** field a measure that returns a value or a list ("Paris;Lyon"). Premium feature ★: without a key, it applies with the watermark. Without a measure, this card has no effect. The details (measure format, bookmarks, persistent filters) are in [the shared basics](/en/tutorials/bien-demarrer-visuels-plume).

| Setting | What it does | Options (default in **bold**) |
|---|---|---|
| Apply | *Once per session*: the preselection applies the first time the slicer is displayed, then the reader is in control (if they change the selection, it doesn't come back when they switch pages). *Reapply on every display*: it comes back every time the page is displayed and whenever the measure's value changes. | ***Once per session*** / *Reapply on every display* |
| Force | Replaces an existing selection: saved in the report, recalled by a bookmark or by persistent filters. When off, that selection is kept and the preselection doesn't apply. | On / **Off** |
| Value separator | Character that separates the values in the text returned by the measure ("Paris;Lyon"). | Free text (**;**) |
| Report values not found (edit mode) | In edit mode, flags in the visual the measure's values that don't exist in the list (typo, filtered-out value). Readers never see this message. | **On** / Off |

### Frame: extra setting and default values

This visual's **Frame** card has one more option than the standard version:

| Setting | What it does | Options (default in **bold**) |
|---|---|---|
| Transparent background | Removes the visual's background. Essential so that only the one-line box is visible when the menu is closed. | **On** / Off |

Its default values also differ from the other visuals: **Border** off and **Inner padding** of 2 px. The background of the Power BI **container** (Format › General › Effects › Background) is a Power BI setting that the visual can't turn off itself: turn it off manually.

Shared cards (Plume Studio License, Style, Frame, Language and numbers): see [the shared basics](/en/tutorials/bien-demarrer-visuels-plume).

## Premium ★ features of this visual

| Feature | Where to set it |
|---|---|
| Hierarchy with 3 to 6 levels | **Field (or hierarchy levels)** well: 3 or more columns (1 or 2 levels are free) |
| Preselection with a measure | **Preselection** field and **Preselection** card |
| Styles, palettes and Theme JSON ★ | **Style** card (see [the shared basics](/en/tutorials/bien-demarrer-visuels-plume)) |

Nothing is locked: without a key, a ★ feature works and shows a "Plume Visuals · Premium preview" watermark; see [the shared basics](/en/tutorials/bien-demarrer-visuels-plume) for the license and [pricing](/en/pricing). The visual inserted with its default settings never shows a watermark.

## Learn more

- [Getting started with Basic Slicer Plume](/en/tutorials/segment-menu-deroulant-hierarchie): the data to prepare and a first visual, step by step.
- [Basic Slicer Plume: 8 how-to guides (list, bookmarks, hierarchy…)](/en/tutorials/basic-slicer-plume-cas-pratiques): recipes for common needs.
- [Getting started with Plume visuals](/en/tutorials/bien-demarrer-visuels-plume): installation, license, styles and settings shared by all visuals.
- The visual's page: [Basic Slicer Plume](/en/visuals/basic-slicer). Have a question? [Support](/en/support).