> ## 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 bar chart race data
## Usage
```python
def bind_bar_chart_race_data(
self,
label: str = None,
values: Union[list, str] = None,
category: str = None,
image: str = None,
captions_from: str = None,
captions_to: str = None,
captions_text: str = None,
captions_image: str = None
)
```
```r
bind_bar_chart_race_data(
.,
label = NULL,
values = NULL,
category = NULL,
image = NULL,
captions_from = NULL,
captions_to = NULL,
captions_text = NULL,
captions_image = NULL
)
```
## Arguments
| Arguments | Type hint | Description |
| ---------------- | ---------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `self` | `Flourish` | Returns the Flourish object |
| `label` | `str`, optional | Label. A column containing the names of the bars, e.g. countries or people. Suggested data type hints: string. Flourish type hint: column |
| `values` | `Union[list, str]`, optional | Values. Multiple columns of numbers, each column representing a point in time Suggested data type hints: number. Flourish type hint: columns |
| `category` | `str`, optional | Categories. Optional category column to color the bars Make sure the Color mode setting is set to By Category in the Bar colors settings panel. Suggested data type hints: string. Flourish type hint: column |
| `image` | `str`, optional | Image. Optional column with URLs of images. Suggested data type hints: string. Flourish type hint: column |
| `captions_from` | `str`, optional | Time to show. Must match the column headers in the main data sheet. Suggested data type hints: string, datetime. Flourish type hint: column |
| `captions_to` | `str`, optional | Time to hide. Must match the column headers in the main data sheet. Suggested data type hints: string, datetime. Flourish type hint: column |
| `captions_text` | `str`, optional | Text. Text or HTML to show. Suggested data type hints: string. Flourish type hint: column |
| `captions_image` | `str`, optional | Image. Image to show. Add an image URL or right-click on a cell to upload an image. Suggested data type hints: string. Flourish type hint: column |
| Arguments | Description |
| ---------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `.` | Returns the Flourish object |
| `label` | Label. A column containing the names of the bars, e.g. countries or people. Suggested data type hints: string. Flourish type hint: column |
| `values` | Values. Multiple columns of numbers, each column representing a point in time Suggested data type hints: number. Flourish type hint: columns |
| `category` | Categories. Optional category column to color the bars Make sure the Color mode setting is set to By Category in the Bar colors settings panel. Suggested data type hints: string. Flourish type hint: column |
| `image` | Image. Optional column with URLs of images. Suggested data type hints: string. Flourish type hint: column |
| `captions_from` | Time to show. Must match the column headers in the main data sheet. Suggested data type hints: string, datetime. Flourish type hint: column |
| `captions_to` | Time to hide. Must match the column headers in the main data sheet. Suggested data type hints: string, datetime. Flourish type hint: column |
| `captions_text` | Text. Text or HTML to show. Suggested data type hints: string. Flourish type hint: column |
| `captions_image` | Image. Image to show. Add an image URL or right-click on a cell to upload an image. Suggested data type hints: string. Flourish type hint: column |