> 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 shows tabular data as rows and columns. Use it to inspect exact values and detailed records.

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="https://2948796384-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LmzGprckLqwd5v6bs6m%2Fuploads%2Fcn58ulKUoMo17quZoC6A%2FScreenshot%20from%202026-01-15%2014-14-00.png?alt=media&amp;token=72392a4e-5600-48ae-9ef9-abce6875a39f" 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="https://2948796384-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LmzGprckLqwd5v6bs6m%2Fuploads%2F8Fn3tsP4adrLZ4v5NsHS%2FScreenshot%20from%202026-01-15%2014-08-59.png?alt=media&amp;token=57d6ce5a-c737-4501-ac66-93a75431e7b5" 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.