> ## Documentation Index
> Fetch the complete documentation index at: https://axiom.co/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Top list

> This section explains how to create top list dashboard elements and add them to your dashboard.

export const elementName_0 = "top list"

export const elementButtonLabel_0 = "Top list"

The top list dashboard element displays the top results from your query, showing the most significant items based on your aggregation and grouping. It can display results as either a table of totals or as time series charts, depending on the aggregation type used.

## Prerequisites

* [Create an Axiom account](https://app.axiom.co/register).
* [Create a dataset in Axiom](/reference/datasets) where you send your data.
* [Send data](/send-data/methods) to your Axiom dataset.
* [Create an empty dashboard](/dashboards/create).

## Create {elementName_0}

1. Go to the Dashboards tab and open the dashboard to which you want to add the {elementName_0}.
2. Click <Icon icon="plus" iconType="regular" /> **Add element** in the top right corner.
3. Click **{elementButtonLabel_0}** from the list.
4. Choose one of the following:
   * Click **Builder** to create your chart using a visual query builder. For more information, see [Create chart using visual query builder](/dashboard-elements/create#create-chart-using-visual-query-builder).
   * Click **APL** to create your chart using the Axiom Processing Language (APL). Create a chart in the same way you create a chart in the [Editor of the Query tab](/query-data/query-editor).
5. Optional: [Configure the dashboard element](/dashboard-elements/configure).
6. Click **Save**.

The new element appears in your dashboard. At the bottom, click **Save** to save your changes to the dashboard.

## Example with Builder

<Frame>
  <img src="https://mintcdn.com/axiom/-Lko8p7oODN6Qd7E/doc-assets/shots/top-list-chart-builder.png?fit=max&auto=format&n=-Lko8p7oODN6Qd7E&q=85&s=12f48f56bae7113206f9b0b03677059f" alt="Top list example with Builder" width="2288" height="1352" data-path="doc-assets/shots/top-list-chart-builder.png" />
</Frame>

## Example with APL

```kusto theme={null}
['sample-http-logs']
| summarize count() by status
| top 10 by count_ desc
```

<Frame>
  <img src="https://mintcdn.com/axiom/-Lko8p7oODN6Qd7E/doc-assets/shots/top-list-chart-apl.png?fit=max&auto=format&n=-Lko8p7oODN6Qd7E&q=85&s=6f7d66346c0035c6870b66d6353b9a4a" alt="Top list example with APL" width="2282" height="1374" data-path="doc-assets/shots/top-list-chart-apl.png" />
</Frame>
