# Lists

A list of features can be used to filter data or perform some analysis e.g. pathway enrichment analysis, or perform visualization like heatmap etc.

* Click on gear <img src="/files/n53qhdxGvF1yBeTeRxjB" alt="" data-size="line"> button on Analysis page the top right corner
* Choose **Settings** in the menu
* Select **Lists** from the left panel of the *Components* section.

To create new list, select the **+ New list** button on the top of the page and give the list a name. Choose between the three list options:

* **Local file**: text file (.txt) on the local computer
* **Text**: manually specify a list of names
* **Hosted lists**: lists hosted by Illumina

When manually specifying a local file or text, only the user who added the list can view and use the lists.

The list name needs to be unique for each user. A description is optional. The list of features can be specified from a .txt file on your local computer by selecting the **Local file** option. The .txt file should contain only one feature per row.

<div align="left"><figure><img src="/files/AYpKsB3UnpYgkbgDlDEo" alt=""><figcaption></figcaption></figure></div>

To manually enter a list of genes, select the **Text** option. Content can be typed into the text field or pasted from the clipboard as one feature per row.

<div align="left"><figure><img src="/files/rD7YNUhNb4nReLmq9hzr" alt=""><figcaption></figcaption></figure></div>

Select **Add list** to add the list. The new list will be added to the list table.

When the *Hosted lists* option is chosen, lists can be downloaded by clicking the check box for each list on the left to select lists and click **Add list.**

<figure><img src="/files/qdc0KgIkK2rOVEIlcVam" alt=""><figcaption></figcaption></figure>

View and sort the name of the list, number of features, owner, and creation date by clicking the column title of the list table. Click on the 3 dots under Actions column to download or edit the list:

<div align="left"><figure><img src="/files/Gh7iKhqrslHnedECks4Q" alt=""><figcaption></figcaption></figure></div>

## Use a Feature list to Select & Filter populations

Feature lists can be used to Select & Filter.

* In the Data Viewer, select the **Style** configuration option
* Choose **Feature list** from *Color by* drop-down list

<figure><img src="/files/apnH8O86uWuaT7FXiOH6" alt=""><figcaption></figcaption></figure>

* Select the **List** of interest using the drop-down
* Choose a **Metric** for the feature list

<figure><img src="/files/5888HBsbCJMrGNQU2nfj" alt=""><figcaption></figcaption></figure>

* Click **Select & Filter** under *Tools* on left
* Use the *Add criteria* drop-down to choose **Gene score**

<figure><img src="/files/O6wEYzyOedZXPNTMju8H" alt=""><figcaption></figcaption></figure>

* Use the slider or text fields to select a population

<figure><img src="/files/CRTVMHyB881cmsRouOPx" alt=""><figcaption></figcaption></figure>

* Use Filter at the top right to **include** (<img src="/files/yijHJ6ZMhncjLGHZQiWl" alt="" data-size="line">) or **exclude** (<img src="/files/46YnxNYRzSNjIknDdBJm" alt="" data-size="line">) this population
* **Apply observation filter** can then be used to filter this population to a specific node in the analysis pipeline

<figure><img src="/files/jsy5NiRCzCbbo0XNCIvc" alt=""><figcaption></figcaption></figure>

To remove this filter, click **Clear filters**.

##


---

# Agent Instructions: Querying This Documentation

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

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.multiomics.illumina.com/icm/analyses/analysis-functionality/settings/lists.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.
