> For the complete documentation index, see [llms.txt](https://docs.ins-pi.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.ins-pi.com/freelucy/views-in-depth/list.md).

# List view

List lays the current record's relationships out as a single table, grouped into **Upstream** and **Downstream**. It is the fastest view for working through a long relationship set, scanning it, and editing in bulk. Like every view, List edits the same record and shares the same staged changes, so the adds, removes, and updates you make here travel with you to Classic and Flow.

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

## What it shows

The table lists every relationship on the current record, grouped under collapsible **Upstream** and **Downstream** headers with a count on each. Each row shows the related record, its relationship type, and which side it sits on.

## Search, group, and sort

* **Search** matches relationships by name, table, and class to narrow a long list.
* **Grouping** (by direction, type, or class) and **sorting** (by name, type, class, or recently added) come from the shared [View Controls](/freelucy/work-in-the-app/view-controls.md) drawer and apply to the table.

## Work with a row

Each relationship is a row with the actions you need:

* **Move to opposite side** with the move control on the row, to update which side it sits on.
* **Remove** the relationship, or **Undo** a staged change, with the action button on the row.
* The row's overflow menu (**⋯**) adds **Jump to record** to recenter the editor, **Open form** to open the ServiceNow record in a new tab, and **Copy sys\_id**.

## Edit in bulk

Select rows with their checkboxes — `Shift`-click for a range, `Cmd/Ctrl`-click to pick individually. When one or more rows are selected, a bulk action bar appears with the selection count, a **Remove** action for the whole selection, and **Clear** to drop the selection.

## Add records

Drag a record from the [Data Hub](/freelucy/work-in-the-app/data-hub.md) onto the table, or use a record's **Add to Upstream** or **Add to Downstream** action. The relationship is staged on that side.

## How staged edits look

List marks staged edits the same way Flow does:

* A **staged add** shows a green accent and a plus badge.
* A **staged removal** shows a strikethrough, with an **Undo** action on the row.

***

## What's next

* [Classic view](/freelucy/views-in-depth/classic.md)
* [Flow view](/freelucy/views-in-depth/flow.md)


---

# 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.ins-pi.com/freelucy/views-in-depth/list.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.