> For the complete documentation index, see [llms.txt](https://docs.avonnicomponents.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.avonnicomponents.com/flow/tutorials/components/list.md).

# List

The List shows Salesforce records or custom items as a list on a flow screen, and sends what the user clicks, ticks or reorders back to the flow. These tutorials follow a sales team through its day: showing deals and contacts, acting on them, then finding and ordering the right one.

{% hint style="info" %}
New to the component? Start with [Show Dates, Times and Links](https://docs.avonnicomponents.com/flow/tutorials/components/list/show-dates-times-and-links.md), which builds the deal list most of these tutorials reuse, and keep the [List reference](https://docs.avonnicomponents.com/flow/flow-components/list.md) open for every property.
{% endhint %}

## Display items

Choose how each item looks and which values it shows.

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-cover data-type="files"></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>Create a grid list with images</strong></td><td>Show an account's Contacts as a grid of photo cards, and set the number of columns and the image size.</td><td><a href="https://27923732-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1FUd4apB9YHgCEMUFbVb%2Fuploads%2FWwJwhtnVrlBzKNXnamyf%2Fcover-list-create-a-grid-list-with-images.png?alt=media">cover-list-create-a-grid-list-with-images.png</a></td><td><a href="https://docs.avonnicomponents.com/flow/tutorials/components/list/create-a-grid-list-with-images.md">Create a grid list with images</a></td></tr><tr><td><strong>Show Dates, Times and Links</strong></td><td>Show close dates, amounts and last update times in each user's own format, and turn every deal name into a link that opens the Opportunity.</td><td><a href="https://27923732-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1FUd4apB9YHgCEMUFbVb%2Fuploads%2FIhiyGgE8wF8CddoPIhxO%2Fcover-list-show-dates-times-and-links.png?alt=media">cover-list-show-dates-times-and-links.png</a></td><td><a href="https://docs.avonnicomponents.com/flow/tutorials/components/list/show-dates-times-and-links.md">Show Dates, Times and Links</a></td></tr></tbody></table>

## Act on items

Add buttons and checkboxes, and send what the user does back to the flow.

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-cover data-type="files"></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>Act on a Row</strong></td><td>Put Log a Call and Mark as Lost buttons on each deal of a List, a New Opportunity button in its header, and route the Screen Flow on the one clicked.</td><td><a href="https://27923732-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1FUd4apB9YHgCEMUFbVb%2Fuploads%2F4LQUsWAu02itYqgQxxUn%2Fcover-list-act-on-a-row.png?alt=media">cover-list-act-on-a-row.png</a></td><td><a href="https://docs.avonnicomponents.com/flow/tutorials/components/list/act-on-a-row.md">Act on a Row</a></td></tr><tr><td><strong>Vertical List with Actions</strong></td><td>List the Contacts of an account with buttons on each one that open the record or start an action.</td><td><a href="https://27923732-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1FUd4apB9YHgCEMUFbVb%2Fuploads%2FdBet8uT9ua9iXkvJJojs%2Fcover-list-vertical-list-with-actions.png?alt=media">cover-list-vertical-list-with-actions.png</a></td><td><a href="https://docs.avonnicomponents.com/flow/tutorials/components/list/vertical-list-with-actions.md">Vertical List with Actions</a></td></tr><tr><td><strong>Build a Checklist That Saves</strong></td><td>Show a sales rep's open Tasks as a checklist on a flow screen and complete every ticked Task in Salesforce when the rep moves on.</td><td><a href="https://27923732-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1FUd4apB9YHgCEMUFbVb%2Fuploads%2F1Hagg0U4nAcGMY3tNj1u%2Fcover-list-build-a-checklist-that-saves.png?alt=media">cover-list-build-a-checklist-that-saves.png</a></td><td><a href="https://docs.avonnicomponents.com/flow/tutorials/components/list/build-a-checklist-that-saves.md">Build a Checklist That Saves</a></td></tr></tbody></table>

## Order and find items

Let users sort, reorder, search and page through a long list.

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-cover data-type="files"></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>Create a sortable list</strong></td><td>Show an account's Contacts and let users sort the list on the field they pick.</td><td><a href="https://27923732-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1FUd4apB9YHgCEMUFbVb%2Fuploads%2FXtdwp3Ini0ZUoyEbFdZA%2Fcover-list-create-a-sortable-list.png?alt=media">cover-list-create-a-sortable-list.png</a></td><td><a href="https://docs.avonnicomponents.com/flow/tutorials/components/list/create-a-sortable-list.md">Create a sortable list</a></td></tr><tr><td><strong>How to Reorder Items and Update Records</strong></td><td>Let users drag items into a new order and save that order to a field on each record.</td><td><a href="https://27923732-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1FUd4apB9YHgCEMUFbVb%2Fuploads%2FHKqbPe3Apb93jKpdI2yx%2Fcover-list-how-to-reorder-items-and-update-records.png?alt=media">cover-list-how-to-reorder-items-and-update-records.png</a></td><td><a href="https://docs.avonnicomponents.com/flow/tutorials/components/list/how-to-reorder-items-and-update-records.md">How to Reorder Items and Update Records</a></td></tr><tr><td><strong>Search, Filter and Paginate a List</strong></td><td>Keep a long List usable on a flow screen: pages or scrolling, a search bar, filter menus and sort options, so users reach the right record fast.</td><td><a href="https://27923732-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1FUd4apB9YHgCEMUFbVb%2Fuploads%2FBgoQR0433C16vSc45k0m%2Fcover-list-search-filter-and-paginate.png?alt=media">cover-list-search-filter-and-paginate.png</a></td><td><a href="https://docs.avonnicomponents.com/flow/tutorials/components/list/search-filter-and-paginate.md">Search, Filter and Paginate a List</a></td></tr></tbody></table>


---

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

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.avonnicomponents.com/flow/tutorials/components/list.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
