<!-- Source: https://docs.squirro.com/en/latest/technical/widgets/built-in/items.html -->
# Items Widget

The Items widget provides the standard way of presenting result sets on Squirro dashboards.

It is the successor to the _Result List_ and _Cards_ widgets and should be used in their place on new projects.

## Data

The Items widget is capable of displaying different data:

- **All items:** shows items matching the dashboard and widget query.
- **Starred items:** shows all items in the user’s Bookmarks collection. The mode name reflects the legacy starred system for backward compatibility.
- **Last read items:** shows the user’s last read items.

## Visualization

There are four main visualization modes available. Their exact display can be configured using additional options, such as _Labels Display_ or _Widget Options_.

### Vertical Cards

[![image1](https://s3.amazonaws.com/download.squirro.net/docs/migrated-attachments/2727444575/2727477357.png)](https://s3.amazonaws.com/download.squirro.net/docs/migrated-attachments/2727444575/2727477357.png)

The Vertical Cards mode shows items as separate cards shown below each other. This usually looks best when the _Disable Card Styling_ option is used, so that the widget itself is not also styled as a card.

### Horizontal Cards

[![image2](https://s3.amazonaws.com/download.squirro.net/docs/migrated-attachments/2727444575/2727248006.png)](https://s3.amazonaws.com/download.squirro.net/docs/migrated-attachments/2727444575/2727248006.png)

The Horizontal Cards mode shows items as separate cards next to each other. This usually looks best when the _Disable Card Styling_ option is used, so that the widget itself is not also styled as a card.

### Vertical List

[![image3](https://s3.amazonaws.com/download.squirro.net/docs/migrated-attachments/2727444575/2727575605.png)](https://s3.amazonaws.com/download.squirro.net/docs/migrated-attachments/2727444575/2727575605.png)

The Vertical List mode shows the items closer together than the _Cards_ modes do.

### Horizontal List

The Horizontal List mode shows the items closer together than the _Cards_ modes do. It offers a scroll feature using two arrow buttons on both sides.

[![image4](https://s3.amazonaws.com/download.squirro.net/docs/migrated-attachments/2727444575/2727608339.png)](https://s3.amazonaws.com/download.squirro.net/docs/migrated-attachments/2727444575/2727608339.png)
