> For the complete documentation index, see [llms.txt](https://docs.apica.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.apica.io/data-management/overview-1/visualizations/list.md).

# List

The List visualization displays data in rows and columns. Use it when you need exact values and detailed records, not visual summaries.

<figure><img src="/files/2T5JCuHbIssr8b5uV5zM" alt=""><figcaption></figcaption></figure>

It’s ideal for:

* Auditing and troubleshooting
* Reviewing raw query output
* Comparing items side-by-side
* Reporting views

### What it represents

* Each row represents one data item.
* Each column represents one field or attribute.

This format shows raw, structured data in a readable form.

### What data it uses

The List visualization works with tabular data, such as:

* Labels
* Metrics
* Text fields
* Numbers

Example input:

```
name    type  value
Item A  X     120
Item B  Y     85
```

### Configure a List visualization

Set **Chart type** to **List**. Then choose which fields to show as columns.

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

### List configuration options

| Option                 | Purpose                                      |
| ---------------------- | -------------------------------------------- |
| Chart type             | Must be **List**.                            |
| Select display columns | Choose which fields appear as table columns. |

### Select display columns

**Select Display Columns** controls which fields are shown in the list.

You can:

* Choose which columns to display
* Hide unnecessary fields
* Focus only on important data

This lets you customize the list for different use cases.

### What this visualization tells you

The List visualization helps you:

* View exact values
* Compare records
* Identify specific items
* Inspect detailed data

It’s best for analysis and reporting.

### When to use List

Use List when:

* You need detailed, row-level data
* You want to scan, sort, or review values
* You are troubleshooting or auditing

### When not to use List

Avoid List when:

* You only need high-level trends
* You want a quick visual summary

Use charts instead in those cases.