# List
The List visualization displays data in rows and columns. Use it when you need exact values and detailed records, not visual summaries.
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.
### 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.
