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

# Chart setup parameters

> Configure shared Setup tab controls for Building BI charts: fields, column options, and sort order.

The **Setup** tab controls the data a chart shows. The **Style** tab controls presentation — see [Chart styling options](/products/building-bi/reference/chart-styling-options). Per-type fields live in [Chart types](/products/building-bi/reference/chart-types).

Every widget needs a data source first. See [Data sources](/products/building-bi/data-sources).

## Field list

| Field type | Description                                           |
| ---------- | ----------------------------------------------------- |
| Metrics    | Pre-aggregated values. View code with `fx`.           |
| Columns    | Source fields. Some calculated fields also show `fx`. |

Edit calculated metrics and columns in the data source — not from the `fx` popup. See [Calculated fields](/products/building-bi/reference/calculated-fields).

After you add a column, open `>` to set type-specific options and rename it for viewers. See [Filter options](/products/building-bi/reference/filter-options).

**Y-Axis Limits** in Setup override **Min/Max Range** on the Style tab.

## Sorting

| Control            | Description                                                |
| ------------------ | ---------------------------------------------------------- |
| Sort toggle (`⇅`)  | Changes sort direction for a column                        |
| Sort Order section | Drag to reorder; add columns; set ASC/DESC; remove columns |

You can sort by a column the widget does not display. Non-displayed sort columns require an aggregate (treated as a metric while sorting).

| Widget type                                                                        | Can sort by                                               | Cannot sort by                           |
| ---------------------------------------------------------------------------------- | --------------------------------------------------------- | ---------------------------------------- |
| Bar, Line, Combo, Pie, Sunburst, Table Aggregated, Polar Bar                       | Dimensions, breakdowns, metrics, other columns as metrics | —                                        |
| Heat-map, Advanced Scatter                                                         | X-Axis, Y-Axis, Metric, other columns as metrics          | —                                        |
| Box-plot                                                                           | Dimension, Metric, other columns as metrics               | Distribute across                        |
| Table Raw                                                                          | Columns, other columns                                    | Calculated metrics                       |
| Slicer                                                                             | Slicer column, other columns as metrics                   | —                                        |
| Tree-map                                                                           | Hierarchy                                                 | Primary/secondary metrics, other columns |
| Time-series                                                                        | Keys, Tooltips                                            | Date, Value, other columns               |
| Timeline                                                                           | Keys, Tooltips                                            | Start/End Time, Bar Label, other columns |
| Table Pivot                                                                        | (limited)                                                 | Columns outside widget configuration     |
| Card, Number, Gauge, Text, I-Frame, Weather, Navigation, Graphics, Sankey, Scatter | Sort not applicable                                       | —                                        |

## Next steps

<CardGroup cols={2}>
  <Card title="Chart types" icon="bar-chart-3" href="/products/building-bi/reference/chart-types" arrow={true}>
    Look up Setup fields per widget type.
  </Card>

  <Card title="Add widgets" icon="layout-dashboard" href="/products/building-bi/dashboards#add-widgets-and-charts" arrow={true}>
    Configure charts on a dashboard.
  </Card>
</CardGroup>