# Build a List Table

### **What is a list table** <a href="#what-is-a-list-table" id="what-is-a-list-table"></a>

This type of table provides a list of values, not ranked by any quantitative criteria. For this reason, the numeric measure column is not mandatory.

![](https://crystal-1aa63e8abb35.intercom-attachments-7.com/i/o/258720009/6ed6ec84835d4c5a7f3af9d8/fN9VvLv29zzQ5shAID5gZNgtAtuj2RpivHkYIBiAmtghywsl1j8didwypKdzeuMW3zMLNHyNwZgHebUnfhYALWzkDrrfugqKxBs87yM2ud5tIWRVBBsaMIFWQR1K-IPRVxHy5Ego)

### **When it’s** **used** <a href="#when-its-used" id="when-its-used"></a>

The list table is used when you simply want a record of available data but you don’t necessarily need to measure it. For example, you can use a list if you want to name all articles of a stock or for filling a contact book with names and addresses of all your clients.

### **How to configure a list table** <a href="#how-to-configure-a-list-table" id="how-to-configure-a-list-table"></a>

The list table is one of the simpler topic types to set up.

For the basic configuration, you only need to indicate the **main group by** **column**. For example, if you simply want to have a list of all your clients, Clients will be your column.

You can also add a **sorting criteria** by clicking on the A-Z button on the left.

{% hint style="info" %}
It is **highly recommended** to identify a sorting column and its direction, ascending or descending. Without this the order of the values could vary each time the topic is asked for in the advisor.
{% endhint %}

![](https://downloads.intercomcdn.com/i/o/368573328/d529f4bda707d568cc9862e0/image.png)

You can decide to add to your table one or more **group by columns,** to aggregate your data on the basis of different criteria and obtain more detailed insights.

![](https://downloads.intercomcdn.com/i/o/368573787/586da91f566dadb9f9acd12c/image.png)

You can choose to group numeric data using [bins](/crystal-console/topics-configuration/configure/data-binning.md). Bins are virtual containers where you can split data on the basis of customized categories: they help you to have a clearer view of your insights.

Another option available is to add a **numeric measure** column and further aggregate your data.

![](https://downloads.intercomcdn.com/i/o/368576306/0c68f7e9ea0c22eb00d6f7f1/image.png)

You will then have to select its corresponding **aggregation function**, by choosing between Average, Sum, Count or Distinct Count, to group together multiple rows and form a single summary value.

![](https://downloads.intercomcdn.com/i/o/368576999/c7f457a244855e4769eec011/image.png)

We’re done!

If you want to know more about other chart types, read [**How to build a ranking table.**](/crystal-console/topics-configuration/visualizations/ranking-table.md)

***


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.igenius.ai/crystal-console/topics-configuration/visualizations/list-table.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
