# Multi-List Selection Feature

SIMKL allows users to organize TV shows, movies, or anime titles into **custom lists** for better tracking and categorization. With the **Multi-List Assignment** feature, users can now add a title to **multiple custom lists simultaneously**, making list management faster, cleaner, and more efficient.

{% hint style="success" %}
This feature improves user experience by allowing a single action to organize content across several curated categories or themes.
{% endhint %}

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

## How to Use the Feature

#### 1. Navigate to the Title

Go to the page of the TV Show, Movie, or Anime you want to add (e.g., *Friends*).

#### 2. Click "Add to Custom List"

Located in the **right-hand panel** under the “Watching” or “Completed” status block.\
You’ll see a button labeled:\
`📋 Add to Custom List (Listed in X lists)`

#### 3. Select Lists

A pop-up window will appear showing all available custom lists categorized under:

* All
* Public
* Private
* Collabs

You can:

* **Search** your list titles using the search bar.
* **Scroll** to browse all available lists.
* **Select multiple checkboxes** to assign the title to more than one list.

#### 4. Add to a New List (Optional)

Click `+ Add to a new list` at the top right of the pop-up if you want to create a brand-new list on the fly.

#### 5. Save & Close

Once done selecting, simply **close** the window. The title is now saved to all selected lists.

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

## What You Can Do With This?

#### 1. **Multi-List Selection**

* Add a single title to **multiple lists simultaneously**.
* Saves time by eliminating the need to open each list individually.
* Works with all list types: Public, Private, Collab, etc.

#### &#x20;2. **Searchable List Menu**

* Use the built-in **search bar** to quickly find specific lists, especially useful for users with dozens or hundreds of lists.
* Search is dynamic and works across all list types.

#### 3. Quickly **Create New Lists**

* From within the popup, you can **create a new list** instantly using the “+ Add to a new list” option.
* Great for spontaneous categorization or mood-based sorting.

#### 4. **List Type Tabs**

* Toggle through different tabs to manage visibility and organization:
  * **All**
  * **Public**
  * **Private**
  * **Collabs**
  * **Voting Lists**
  * **Tier Lists**
* Easily control how each list is used and who can see it.

#### 5. **Auto-Saving Selections**

* Once a checkbox is selected or deselected, the change is saved **immediately,** no need to click a Save or Apply button.

#### 6. **List Counter**

* The "Listed in X lists" label under the `Add to Custom List` button shows how many lists this title already belongs to.
* Hovering or clicking it opens the selection popup with all current associations highlighted.

#### 7. **Quick Removal from Lists**

* To **remove** a title from one or more lists:
  * Reopen the popup
  * Uncheck the relevant boxes
  * Changes apply immediately

***

## Tips

* Your list choices are saved instantly after checkbox selection — no additional “Save” button is needed.
* You can remove a title from a list the same way by unchecking it in the same menu.
* Tier and Voting lists may have unique behaviors depending on their settings.
* Use emojis, tags, or descriptions in your list names to better organize and identify them.


---

# 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://docs.simkl.org/how-to-use-simkl/core-features/watchlists-and-custom-lists/custom-lists/creating-and-managing-custom-lists/multi-list-selection-feature.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.