> ## Documentation Index
> Fetch the complete documentation index at: https://www.canva.dev/opensource/flourish-charts/llms.txt
> Use this file to discover all available pages before exploring further.
# Bind hierarchy data
## Usage
```python
def bind_hierarchy_data(
self,
nest_columns: Union[list, str] = None,
size_columns: Union[list, str] = None,
filter: str = None,
popup_metadata: Union[list, str] = None
)
```
```r
bind_hierarchy_data(
.,
nest_columns = NULL,
size_columns = NULL,
filter = NULL,
popup_metadata = NULL
)
```
## Arguments
| Arguments | Type hint | Description |
| ---------------- | ---------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `self` | `Flourish` | Returns the Flourish object |
| `nest_columns` | `Union[list, str]`, optional | Categories/nesting. Choose one or more categorical columns to nest by. The data is nested in the same order as the chosen columns (e.g. C, B is different from B, C). Suggested data type hints: string. Flourish type hint: columns |
| `size_columns` | `Union[list, str]`, optional | Size by. Optionally choose one or more numeric columns to size by. If more than one is chosen, a dropdown will appear in the visualization which lets the user choose. Rows with negative values are excluded. Suggested data type hints: number. Flourish type hint: columns |
| `filter` | `str`, optional | Filter. Optionally choose a categorical column to filter by. Suggested data type hints: string, number, datetime. Flourish type hint: column |
| `popup_metadata` | `Union[list, str]`, optional | Info for popups. One or more columns of information (text, image URLs , embedded charts etc) to include in popups and panels Suggested data type hints: string, number, datetime. Flourish type hint: columns |
| Arguments | Description |
| ---------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `.` | Returns the Flourish object |
| `nest_columns` | Categories/nesting. Choose one or more categorical columns to nest by. The data is nested in the same order as the chosen columns (e.g. C, B is different from B, C). Suggested data type hints: string. Flourish type hint: columns |
| `size_columns` | Size by. Optionally choose one or more numeric columns to size by. If more than one is chosen, a dropdown will appear in the visualization which lets the user choose. Rows with negative values are excluded. Suggested data type hints: number. Flourish type hint: columns |
| `filter` | Filter. Optionally choose a categorical column to filter by. Suggested data type hints: string, number, datetime. Flourish type hint: column |
| `popup_metadata` | Info for popups. One or more columns of information (text, image URLs , embedded charts etc) to include in popups and panels Suggested data type hints: string, number, datetime. Flourish type hint: columns |