# Buttons

{% hint style="info" %}
**Tips**

Buttons are best when used with a maximum 3-4 different values
{% endhint %}

<div align="center"><figure><img src="https://1809014303-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZxYYf1KpgarKMgMsDCrw%2Fuploads%2Fgit-blob-494408fb6466dbba12d056c6fb1e4ae2c53bf827%2Fapp-filter-buttons.png?alt=media" alt="app-filter-checkboxes"><figcaption><p>Buttons, multiple selection - in-header style</p></figcaption></figure></div>

## Options

Filter options are editable fields that allow you to customize your button filter.

| Section       | Option               | Description                                                                                 |
| ------------- | -------------------- | ------------------------------------------------------------------------------------------- |
|               | Name                 | Name of the filter display                                                                  |
| Sort          | Order                | Sort the values order alphabetically (it's default), reverse or depending on another column |
| Format        | Date format          | Specify how the date should be displayed (when you're dimension is a date)                  |
| Display       | Default value        | Choose the default value selected for your users                                            |
| Display       | Select all           | Choose text to display when filter isn't applied (all values taken into account)            |
| Display       | Selection type value | Either `single` or `multiple`                                                               |
| Sort          | Order                |                                                                                             |
| Enrich filter | Additional variables | Choose other columns from the source dataset to be exposed on the filters as variables.     |

<figure><img src="https://1809014303-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZxYYf1KpgarKMgMsDCrw%2Fuploads%2Fgit-blob-d78209358ab2d8a3c8ce945e9c630a1b6eb819eb%2Fstory-filter-buttons.png?alt=media" alt="story-filter-checkboxes"><figcaption><p>Buttons - Single selection - -in-story style</p></figcaption></figure>

## Information

In the "Information" section, you can retrieve filter properties, such as the id, useful for Templating (cf. [Templating from Filters' values](https://docs-v3.toucantoco.com/visualizations-and-layouts/apps/filters/templating-from-filters-values))

| Option  | Description                                  |
| ------- | -------------------------------------------- |
| id      | Unique identifier of the Filter              |
| dataset | Source dataset                               |
| column  | Column from which filter's values comes from |

{% hint style="warning" %}
**Warning**

Will maximum display the first 50 values only.
{% endhint %}