> For the complete documentation index, see [llms.txt](https://docs.simkl.org/how-to-use-simkl/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](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).

# 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
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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` 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>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.