> ## Documentation Index
> Fetch the complete documentation index at: https://docs.arya.so/llms.txt
> Use this file to discover all available pages before exploring further.

# Static vs dynamic lists

> Choose between manual or filter-populated lists. Convert between types when needed.

Every Arya list is **static** or **dynamic**. The choice determines how records are added.

## Differences

|                   | Static                                 | Dynamic                                     |
| ----------------- | -------------------------------------- | ------------------------------------------- |
| Population        | Manual (add records one by one)        | Automatic (filter always active)            |
| Content over time | Stable (changes only if you edit)      | Evolves with data                           |
| Typical use       | Email campaign to hand-picked contacts | Evolving segment (e.g. "open deals > €50k") |
| Bulk edit         | Yes                                    | Yes (but records may exit after edit)       |

## Static list

<Steps>
  <Step title="Create">
    **Lists → + New list → Static** → pick object (deal, company, contact...).
  </Step>

  <Step title="Add records">
    Click **Add records** → search by name or use temporary filters → select and add.
  </Step>

  <Step title="Manage membership">
    Remove single records with **⋯ → Remove from list** (doesn't delete the record, only membership).
  </Step>
</Steps>

**Example**: list "VIP conference 2026" — invited contacts. The list doesn't change even if contacts get added/removed from deals.

## Dynamic list

<Steps>
  <Step title="Create">
    **Lists → + New list → Dynamic** → pick object.
  </Step>

  <Step title="Define filters">
    Add conditions (`stage = Negotiation`, `value > 20000`, `owner = me`). AND by default, you can use OR groups.

    <Frame>
      <img src="https://mintcdn.com/agevole/cM9eEPJE8FVhTNOb/images/liste/en/dynamic-filters.svg?fit=max&auto=format&n=cM9eEPJE8FVhTNOb&q=85&s=0673625fb9d734bd6e790f02cb36e000" alt="Dynamic filter editor with combined conditions" width="1200" height="720" data-path="images/liste/en/dynamic-filters.svg" />
    </Frame>
  </Step>

  <Step title="Save">
    Arya shows live preview. On save, the list always contains every record matching the filters.
  </Step>
</Steps>

**Example**: list "Overdue unpaid invoices" — `status = overdue AND paid = false`. Every newly overdue unpaid invoice enters automatically; when paid, it exits.

## Convert static to dynamic (or vice versa)

<Steps>
  <Step title="Open list settings">
    List → **⋯ → Settings**.
  </Step>

  <Step title="Change type">
    * **Static to dynamic**: add filters. Current members aren't guaranteed to stay if they don't match.
    * **Dynamic to static**: Arya freezes the list: currently included records become fixed members, filter is removed.
  </Step>
</Steps>

## Sharing

Any list can be:

* **Private**: only you
* **Team**: team members see and edit
* **Workspace**: everyone can view (only admins can edit)

Set in **List → ⋯ → Share**.

## Frequently asked questions

<AccordionGroup>
  <Accordion title="How many records can a list hold?">
    No hard limit. Lists with 100,000+ records may be slow to load — use filters to narrow down.
  </Accordion>

  <Accordion title="If I remove a record from a static list, is it deleted?">
    No. You only remove membership. The record (deal, company, etc.) stays intact.
  </Accordion>

  <Accordion title="Can I combine static list + filters?">
    Not directly, but you can create a filtered view on the static list without changing its type.
  </Accordion>
</AccordionGroup>