> ## 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 |