> For the complete documentation index, see [llms.txt](https://help.twinr.dev/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.twinr.dev/native-screen/list-element.md).

# List Element

A set of linked cards — in a grid, a column, or a scrolling row.

A List element shows a set of cards, each with its own image, label and link. Use it for categories, shop sections, navigation shortcuts or an article feed.

All three types hold the same content — an image, a title and a link per item. They differ only in how that content is laid out, so you can switch between them without rebuilding the list.

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>Grid</strong></td><td>Cards in rows and columns, two to four across.</td><td><a href="https://help.twinr.dev/native-screen/list-element/list-grid-element.md">List Grid Element</a></td></tr><tr><td><strong>Vertical</strong></td><td>A single column, stacked down the screen.</td><td><a href="https://help.twinr.dev/native-screen/list-element/list-vertical-element.md">List Vertical Element</a></td></tr><tr><td><strong>Horizontal</strong></td><td>A row that scrolls sideways.</td><td><a href="https://help.twinr.dev/native-screen/list-element/list-horizontal-element.md">List Horizontal Element</a></td></tr></tbody></table>

## Which one to use

**Grid** when the items are equally important and you want them all visible at once — top-level categories on a home screen.

**Vertical** when each item needs room to be read: articles, services, a menu with descriptions.

**Horizontal** when the list is a highlight rather than the main event. It takes one row of space no matter how many items you add, which keeps what's below it on screen.

{% hint style="info" %}
A horizontal row only shows two or three cards at a time, so anything further along is out of sight. Put your strongest items first, and prefer a grid when customers genuinely need to compare the whole set.
{% endhint %}
