# Data Binding Settings 

Describes how the data displayed in the data chart is setup using the Data Chart Panel's Data Binding section.

## Content

The Data Binding tab in the **Data Chart Panel** allows you to bind a Data Chart to a DataManager table or to a specific cell in a ReportSheet.
Data displayed in the chart is configured through this panel.

## Binding Modes

The Data Chart Panel provides two binding modes:

* Table Binding
* Cell Binding (ReportSheet only)

## Table Binding

When binding a Data Chart to a DataManager table:

1. Select the table from the **Selected Table** dropdown.
2. Bind the required fields to the corresponding data areas.
3. Configure field options if needed.

If you switch the bound table, all previously bound fields are cleared and must be configured again.
To add a data source:

1. Go to **DATA** \> **Data Binding**
2. Click **DataSource**
3. Add a table and configure the external URL for CRUD operations (if applicable)
4. Use the Columns tab to fetch table columns

![2.1](https://cdn.mescius.io/document-site-files/images/7719ad0a-f083-46d7-aff6-f63e2e187c15/2.1.7d8d4e.png?width=800)
After fetching the data source, select the table in the **Data Chart Panel**.
![image](https://cdn.mescius.io/document-site-files/images/b2223940-43c2-44cf-8eda-f5ab9acd84f0/image.d84160.png?width=400)

### Field Areas in the Data Chart Panel

The following binding areas are available:

* **Values** – Defines the numeric data displayed in the chart.
* **Category** – Defines the primary grouping field(s).
* **Details** – Adds additional grouping dimensions.
* **Color** – Splits data visually into multiple series.
* **Tooltip** – Adds additional information to chart tooltips.
* **Filter** – Applies source-level filtering to the bound data.

![image](https://cdn.mescius.io/document-site-files/images/b2223940-43c2-44cf-8eda-f5ab9acd84f0/image.4302db.png?width=400)
Use the **Filter** icon to create filter rules for fields in the currently selected table.
![2.4](https://cdn.mescius.io/document-site-files/images/7719ad0a-f083-46d7-aff6-f63e2e187c15/2.4.5f9012.png?width=250)

### Category Field Binding

Users can drag one or more categorical fields into the **Category** drop zone.
![dragField.gif](https://cdn.mescius.io/document-site-files/images/b2223940-43c2-44cf-8eda-f5ab9acd84f0/dragField-20260402.8fe4d2.gif?width=800)
The drop zone is the same single area used for standard Category binding.
All dropped fields are stored internally as an ordered array.
Multiple fields can be added sequentially. During drag‑and‑drop, the editor displays an insertion indicator showing where the field will be inserted.
The drop order determines the hierarchy from outer level to inner level.
Produces a hierarchical category structure ordered by drop sequence.
After binding a field, click the **Settings** button next to it to configure options such as sorting, aggregation, formatting, or chart-specific behavior.

>type=note
> **Note**:
> Different chart types require different binding structures. Refer to the documentation for each chart type for detailed binding requirements. 
> When switching between chart types in the Designer:
>
> * If both the current and target chart types support hierarchical categories, the full category hierarchy is preserved.
> * If the target chart type uses a single category level only, only the first category level is kept.
> * If the target chart type does not use category binding, the category binding is removed.

## Cell Binding (ReportSheet Only)

In a ReportSheet, you can bind a Data Chart to an individual expandable cell.

1. Select **Cell Binding** from the **Binding Mode** dropdown.
2. Click the **+** button in each binding area.
3. Select the target cell.

Each bound cell has a **Display Name**, which acts as an alias and is displayed in the chart.
![image](https://cdn.mescius.io/document-site-files/images/b2223940-43c2-44cf-8eda-f5ab9acd84f0/image.639844.png?width=400)

>type=note
> **Note**:
>
> * When a Data Chart in a ReportSheet is bound to a cell reference, the chart renders default binding data during design time.
> * Switch to **Preview** or **Paginate** mode to view actual bound data.