# Lists

**About:**

* Lists are static - When you create a list, it captures the state of the companies/people/locations at that point in time, and the list contents do not automatically update as the underlying data changes.
* You can create a list from a filter, which will include all records matching that filter at the time the list is created.
* You can also upload a CSV to create a list, which will include just the records in that CSV.
* Lists are useful for things like sales rep book assignments, custom reporting, etc. where you want a fixed set of records to work with.
* If you need a dynamic view that updates as the universe data changes, you would use a view instead of a list.

**Common Use Cases:**

* Assigning a book of business to each sales or post-sales rep
* Capturing a one-time CSV upload of target accounts
* Storing the output of a specific campaign or outreach batch
* Grouping accounts by contract, tier, or lifecycle stage for manual management

#### 🎥 **Lists Walkthrough** <a href="#discover-video-walkthrough-38" id="discover-video-walkthrough-38"></a>

Watch this quick video to see how lists work.

<br>


---

# 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.withorbital.com/orbital-2.0/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.
