> For the complete documentation index, see [llms.txt](https://help.tellius.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.tellius.com/tellius-6.3/vizpads-explore/control-filters/single-select-list.md).

# Single-select list

Create single-select list filters to apply one value across all charts in a Vizpad. Search, sort, and apply clean, focused filtering with ease.

When you create a single-select list, a control filter widget named "***Single-select List (chosen\_column)***" with two nested lists **Include** and **Exclude**, and the list of all available values for the selected column will be displayed.

### Creating a single-select list

1. From the required Business View, select the dimension for which you want to apply filters.
2. Click on the pencil icon to rename the multi-select control filter.
3. To sort the filter values, click on the sorting icon to sort the values in ascending or descending order.
4. To search for a specific value, start typing the value in the search bar provided and the values matching your input will be displayed.
5. **Include** list displays the value considered for filter. **Exclude** list displays the list of excluded values. By default, **Include** list will be selected.

{% hint style="warning" %}
Unlike a multi-select filter, only one value can be selected for a single-select filter.
{% endhint %}

<figure><img src="https://content.gitbook.com/content/M1pa9Nct9EmVU4Ol8Mol/blobs/k9uMqy5IVYaa114lQiPX/image.png" alt="" width="313"><figcaption><p>Single-select list</p></figcaption></figure>

### Selecting the value

1. Once the required value is selected, click on **Apply** to apply the filter or click on **Undo** to revert to the previously saved state.
2. The filter will be applied to all the charts in the Vizpad that were created using the specific Business View, and a global filter pill will be created that reflects the applied control filter.

{% hint style="info" %}
The list of available values will display the first 300 values. Further scrolling will display the remaining values.
{% endhint %}

<figure><img src="https://content.gitbook.com/content/M1pa9Nct9EmVU4Ol8Mol/blobs/GrJGG9C7ayg5j6mTi3kz/ezgif-com-video-to-gif-3.gif" alt="" width="450"><figcaption><p>Single-select filter</p></figcaption></figure>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://help.tellius.com/tellius-6.3/vizpads-explore/control-filters/single-select-list.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.