# Filter setup (optional)

**The filter settings allow you to control which fields the List View can be filtered on.**

<figure><img src="https://3800415611-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNuSjRiJMvVhtdzNDzWBi%2Fuploads%2F9RBZvEc0LuGi8XrbEuZw%2Fimage%20(27).png?alt=media&#x26;token=f12bba30-2bed-413a-84c2-5fbd5fc88a7a" alt=""><figcaption></figcaption></figure>

* [**Basic settings**](#basic-settings)

  Adjust basic settings, like filter layout and button position.
* [**Add or edit filters**](#adding-and-editing-filters)

  The list can be filtered on any field in the underlying object, and you can configure the filters based on the filter type.

  * [**Add a filter**](#adding-filters)
  * [**Edit a filter**](#editing-filters)

***

### Basic settings

Adjust basic settings, like filter layout and button position.

<figure><img src="https://3800415611-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNuSjRiJMvVhtdzNDzWBi%2Fuploads%2FFUmpC96kjHg4JYl3kJbQ%2Fimage%20(28).png?alt=media&#x26;token=a7718f63-7cfb-450b-b141-2e9ffbd90fc3" alt=""><figcaption></figcaption></figure>

<table><thead><tr><th width="227">Field name</th><th width="339">Description</th><th>Req.</th></tr></thead><tbody><tr><td>Preserve Filter Values</td><td>Make filter settings persist by storing the most recently used filter values locally.</td><td></td></tr><tr><td>Filter Layout</td><td><p>Controls the number of filters shown per line.</p><ul><li>3 of 12 : Shows four filter dropdowns per line. (default)</li><li>4 of 12 : Shows three filter dropdowns per line.</li></ul></td><td><mark style="color:red;">✔️</mark></td></tr><tr><td>Search Button Position</td><td><p>Controls the position of the search button.</p><ul><li>Right Column: the search button will appear at the right side of the filters. (default)</li><li>Last Column: the search button will appear in the last column.</li></ul></td><td><mark style="color:red;">✔️</mark></td></tr></tbody></table>

### Adding and editing filters

The list can be filtered on any field in the underlying object, and you can configure the filters based on the filter type.

#### Adding filters

The available filter options are based on fields in the underlying object which the list is based on.

<figure><img src="https://3800415611-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNuSjRiJMvVhtdzNDzWBi%2Fuploads%2FIO1HJCqJ86cFQTsa1sjZ%2Fimage%20(29).png?alt=media&#x26;token=98fb4a54-d5e0-4da6-bc19-1d83af95babf" alt=""><figcaption></figcaption></figure>

1. Click the `Add Filters` button.
2. In the pop-up window that opens, select the fields you want to add to the filter.
3. When you have finished selecting the fields to filter by, click the `Add button`.

#### Editing filters

You can configure the properties depending on the data type of the filter field.

{% hint style="warning" %}
**Available filter types**

* Text
* Number
* Currency
* Multiple choice
* Date
* Date / time (only available in date format)
* Lookup
* Checkbox
  {% endhint %}

<figure><img src="https://3800415611-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNuSjRiJMvVhtdzNDzWBi%2Fuploads%2FQZdG5p29Rql1CYzraCp8%2Fimage%20(30).png?alt=media&#x26;token=304da93d-b819-46ec-96c3-fe4442c0eeed" alt=""><figcaption><p>Setting up a filter on a Text-type field.</p></figcaption></figure>

<figure><img src="https://3800415611-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNuSjRiJMvVhtdzNDzWBi%2Fuploads%2F1wRBAHQsdiA4W5M26bmY%2Fimage%20(31).png?alt=media&#x26;token=cde8b906-8772-4ae5-9e85-4671c7b14bf6" alt=""><figcaption><p>Setting up a filter on a Number-type field.</p></figcaption></figure>

<table><thead><tr><th width="160">Field name</th><th width="406">Description</th><th>Req.</th></tr></thead><tbody><tr><td>Field</td><td>The API name of the field being used as a filter.</td><td><mark style="color:red;">✔️</mark></td></tr><tr><td>Label</td><td>The display name of the filter.</td><td><mark style="color:red;">✔️</mark></td></tr><tr><td>Match Condition</td><td><p>Specify the type of match to use with a Text-type filter.</p><ul><li>Contains (default)</li><li>Equals</li><li>Start with</li></ul></td><td></td></tr><tr><td>Search Type</td><td><p>Specify how to use Number-type filters.</p><ul><li>Operators: use operators (=,&#x3C;=,>=... etc). (default)</li><li>Range (From, To): Specify a range to search within.</li></ul></td><td></td></tr></tbody></table>