BarChart

BarChart is a component for drawing bar charts to compare multiple sets of data.

interface Data {
  date: string
  desktop: number
  mobile: number
  tablet: number
}

const series = useMemo<BarChart.BarProps<Data>[]>(
  () =>
    BarChart.mergeSeries([
      { dataKey: "desktop" },
      { dataKey: "tablet" },
      { dataKey: "mobile" },
    ]),
  [],
)
const data = useMemo<Data[]>(
  () => [
    {
      date: "2026-03-01",
      desktop: faker.number.int({ max: 5000, min: 1000 }),
      mobile: faker.number.int({ max: 5000, min: 1000 }),
      tablet: faker.number.int({ max: 5000, min: 1000 }),
    },
    {
      date: "2026-04-01",
      desktop: faker.number.int({ max: 5000, min: 1000 }),
      mobile: faker.number.int({ max: 5000, min: 1000 }),
      tablet: faker.number.int({ max: 5000, min: 1000 }),
    },
    {
      date: "2026-05-01",
      desktop: faker.number.int({ max: 5000, min: 1000 }),
      mobile: faker.number.int({ max: 5000, min: 1000 }),
      tablet: faker.number.int({ max: 5000, min: 1000 }),
    },
    {
      date: "2026-06-01",
      desktop: faker.number.int({ max: 5000, min: 1000 }),
      mobile: faker.number.int({ max: 5000, min: 1000 }),
      tablet: faker.number.int({ max: 5000, min: 1000 }),
    },
    {
      date: "2026-07-01",
      desktop: faker.number.int({ max: 5000, min: 1000 }),
      mobile: faker.number.int({ max: 5000, min: 1000 }),
      tablet: faker.number.int({ max: 5000, min: 1000 }),
    },
    {
      date: "2026-08-01",
      desktop: faker.number.int({ max: 5000, min: 1000 }),
      mobile: faker.number.int({ max: 5000, min: 1000 }),
      tablet: faker.number.int({ max: 5000, min: 1000 }),
    },
  ],
  [],
)

return (
  <BarChart.Root
    data={data}
    series={series}
    tooltipProps={{
      labelFormatter: (value) => dayjs(value).format("MMM"),
    }}
    xAxisProps={{
      dataKey: "date",
      tickFormatter: (value) => dayjs(value).format("MMM"),
    }}
  />
)

Usage

import { BarChart } from "@yamada-ui/react"

import { BarChart } from "@/components/ui"

import { BarChart } from "@workspaces/ui"

<BarChart.Root>
  <BarChart.Bar>
    <BarChart.LabelList />
  </BarChart.Bar>
  <BarChart.Label />
  <BarChart.ReferenceLine />
  <BarChart.Grid />
  <BarChart.XAxis />
  <BarChart.YAxis />
  <BarChart.Tooltip />
  <BarChart.Legend />
</BarChart.Root>

Composition

const data = useMemo<Data[]>(() => createCartesianChartData(), [])

return (
  <BarChart.Root data={data}>
    <BarChart.Tooltip labelFormatter={(value) => dayjs(value).format("MMM")} />
    <BarChart.XAxis
      dataKey="date"
      tickFormatter={(value) => dayjs(value).format("MMM")}
    />
    <BarChart.Bar dataKey="desktop">
      <BarChart.LabelList />
    </BarChart.Bar>
    <BarChart.Bar dataKey="tablet" />
    <BarChart.Bar dataKey="mobile" />
  </BarChart.Root>
)

Change Size

const series = useMemo<BarChart.BarProps<Data>[]>(
  () =>
    BarChart.mergeSeries([
      { dataKey: "desktop" },
      { dataKey: "tablet" },
      { dataKey: "mobile" },
    ]),
  [],
)
const data = useMemo(() => createCartesianChartData(), [])

return (
  <VStack>
    <For each={["xs", "sm", "md", "lg", "xl"]}>
      {(size, index) => (
        <BarChart.Root
          key={index}
          size={size}
          data={data}
          series={series}
          tooltipProps={{
            labelFormatter: (value) => dayjs(value).format("MMM"),
          }}
          xAxisProps={{
            dataKey: "date",
            tickFormatter: (value) => dayjs(value).format("MMM"),
          }}
        />
      )}
    </For>
  </VStack>
)

Change Color Scheme

const series = useMemo<BarChart.BarProps<Data>[]>(
  () =>
    BarChart.mergeSeries([
      { dataKey: "desktop" },
      { dataKey: "tablet" },
      { dataKey: "mobile" },
    ]),
  [],
)
const data = useMemo(() => createCartesianChartData(), [])

return (
  <BarChart.Root
    colorScheme="blue"
    data={data}
    series={series}
    tooltipProps={{
      labelFormatter: (value) => dayjs(value).format("MMM"),
    }}
    xAxisProps={{
      dataKey: "date",
      tickFormatter: (value) => dayjs(value).format("MMM"),
    }}
  />
)

Change Color

const series = useMemo<BarChart.BarProps<Data>[]>(
  () => [
    { dataKey: "desktop", color: "red" },
    { dataKey: "tablet", color: "blue" },
    { dataKey: "mobile", color: "green" },
  ],
  [],
)
const data = useMemo(() => createCartesianChartData(), [])

return (
  <BarChart.Root
    data={data}
    series={series}
    tooltipProps={{
      labelFormatter: (value) => dayjs(value).format("MMM"),
    }}
    xAxisProps={{
      dataKey: "date",
      tickFormatter: (value) => dayjs(value).format("MMM"),
    }}
  />
)

Range

To display a range, set the values of the data items as [min, max] arrays.

const series = useMemo<BarChart.BarProps<Data>[]>(
  () => [{ dataKey: "desktop" }, { dataKey: "tablet" }, { dataKey: "mobile" }],
  [],
)
const data = useMemo<Data[]>(
  () =>
    Array.from({ length: 6 }, (_, index) => ({
      date: dayjs().add(index, "month").format("YYYY-MM-DD"),
      desktop: [
        faker.number.int({ min: 1000, max: 2000 }),
        faker.number.int({ min: 4000, max: 5000 }),
      ],
      mobile: [
        faker.number.int({ min: 1000, max: 2000 }),
        faker.number.int({ min: 4000, max: 5000 }),
      ],
      tablet: [
        faker.number.int({ min: 1000, max: 2000 }),
        faker.number.int({ min: 4000, max: 5000 }),
      ],
    })),
  [],
)

return (
  <BarChart.Root
    data={data}
    series={series}
    tooltipProps={{
      labelFormatter: (value) => dayjs(value).format("MMM"),
    }}
    xAxisProps={{
      dataKey: "date",
      tickFormatter: (value) => dayjs(value).format("MMM"),
    }}
  />
)

Stacked

To stack the series, set stackId in series or barProps.stackId to a string.

const series = useMemo<BarChart.BarProps<Data>[]>(
  () => [
    { dataKey: "desktop", color: "red" },
    {
      dataKey: "tablet",
      color: "blue",
      radius: [0, 0, 4, 4],
      stackId: "stack",
    },
    {
      dataKey: "mobile",
      color: "green",
      radius: [4, 4, 0, 0],
      stackId: "stack",
    },
  ],
  [],
)
const data = useMemo(() => createCartesianChartData(), [])

return (
  <BarChart.Root
    data={data}
    series={series}
    tooltipProps={{
      labelFormatter: (value) => dayjs(value).format("MMM"),
    }}
    xAxisProps={{
      dataKey: "date",
      tickFormatter: (value) => dayjs(value).format("MMM"),
    }}
  />
)

Percent

To make the series a percentage, set stackId or barProps.stackId to a string and set chartProps.stackOffset to "expand".

const series = useMemo<BarChart.BarProps<Data>[]>(
  () => [
    { dataKey: "desktop", color: "red" },
    { dataKey: "tablet", color: "blue" },
    { dataKey: "mobile", color: "green" },
  ],
  [],
)
const data = useMemo(() => createCartesianChartData(), [])

return (
  <BarChart.Root
    data={data}
    series={series}
    withYAxis
    barProps={{ radius: 0, stackId: "stack" }}
    chartProps={{ stackOffset: "expand" }}
    tooltipProps={{
      labelFormatter: (value) => dayjs(value).format("MMM"),
    }}
    xAxisProps={{
      dataKey: "date",
      tickFormatter: (value) => dayjs(value).format("MMM"),
    }}
    yAxisProps={{
      tickFormatter: (value) => `${(Number(value) * 100).toFixed(0)}%`,
    }}
  />
)

Add Y Axis

To add the Y axis, set withYAxis to true. The default is false.

const series = useMemo<BarChart.BarProps<Data>[]>(
  () =>
    BarChart.mergeSeries([
      { dataKey: "desktop" },
      { dataKey: "tablet" },
      { dataKey: "mobile" },
    ]),
  [],
)
const data = useMemo(() => createCartesianChartData(), [])

return (
  <BarChart.Root
    data={data}
    series={series}
    withYAxis
    chartProps={{ margin: { right: 16 } }}
    tooltipProps={{
      labelFormatter: (value) => dayjs(value).format("MMM"),
    }}
    xAxisProps={{
      dataKey: "date",
      tickFormatter: (value) => dayjs(value).format("MMM"),
    }}
  />
)

To change the orientation of the Y axis, set yAxisProps.orientation to "start" or "end". The default is "start".

const series = useMemo<BarChart.BarProps<Data>[]>(
  () =>
    BarChart.mergeSeries([
      { dataKey: "desktop" },
      { dataKey: "tablet" },
      { dataKey: "mobile" },
    ]),
  [],
)
const data = useMemo(() => createCartesianChartData(), [])

return (
  <BarChart.Root
    data={data}
    series={series}
    withYAxis
    chartProps={{ margin: { left: 16 } }}
    tooltipProps={{
      labelFormatter: (value) => dayjs(value).format("MMM"),
    }}
    xAxisProps={{
      dataKey: "date",
      tickFormatter: (value) => dayjs(value).format("MMM"),
    }}
    yAxisProps={{ orientation: "end" }}
  />
)

To add the legend, set withLegend to true. The default is false. To change the placement of the legend, set legendProps.placement to "start-start", "end-end", etc. The default is "start-end".

const series = useMemo<BarChart.BarProps<Data>[]>(
  () => [
    { dataKey: "desktop", color: "red" },
    { dataKey: "tablet", color: "blue" },
    { dataKey: "mobile", color: "green" },
  ],
  [],
)
const data = useMemo(() => createCartesianChartData(), [])

return (
  <BarChart.Root
    data={data}
    series={series}
    withLegend
    tooltipProps={{
      labelFormatter: (value) => dayjs(value).format("MMM"),
    }}
    xAxisProps={{
      dataKey: "date",
      tickFormatter: (value) => dayjs(value).format("MMM"),
    }}
  />
)

Change Name

To change the name of the tooltip or legend, set name to a string in series.

const series = useMemo<BarChart.BarProps<Data>[]>(
  () => [
    { dataKey: "desktop", name: "Desktop", color: "red" },
    { dataKey: "tablet", name: "Tablet", color: "blue" },
    { dataKey: "mobile", name: "Mobile", color: "green" },
  ],
  [],
)
const data = useMemo(() => createCartesianChartData(), [])

return (
  <BarChart.Root
    data={data}
    series={series}
    withLegend
    tooltipProps={{
      labelFormatter: (value) => dayjs(value).format("MMM"),
    }}
    xAxisProps={{
      dataKey: "date",
      tickFormatter: (value) => dayjs(value).format("MMM"),
    }}
  />
)

Change Grid

To change the grid, set horizontal and vertical to a boolean in gridProps.

const series = useMemo<BarChart.BarProps<Data>[]>(
  () =>
    BarChart.mergeSeries([
      { dataKey: "desktop" },
      { dataKey: "tablet" },
      { dataKey: "mobile" },
    ]),
  [],
)
const data = useMemo(() => createCartesianChartData(), [])

return (
  <VStack>
    <For each={["xy", "x", "y", "none"]}>
      {(value, index) => (
        <BarChart.Root
          key={index}
          gridProps={{
            horizontal: value.includes("x"),
            vertical: value.includes("y"),
          }}
          data={data}
          series={series}
          tooltipProps={{
            labelFormatter: (value) => dayjs(value).format("MMM"),
          }}
          xAxisProps={{
            dataKey: "date",
            tickFormatter: (value) => dayjs(value).format("MMM"),
          }}
        />
      )}
    </For>
  </VStack>
)

Add Label

To add a label, set label of series or barProps.label to true. The default is false.

const series = useMemo<BarChart.BarProps<Data>[]>(
  () => BarChart.mergeSeries([{ dataKey: "desktop" }]),
  [],
)
const data = useMemo(() => createCartesianChartData(), [])

return (
  <BarChart.Root
    data={data}
    series={series}
    barProps={{ label: true }}
    tooltipProps={{
      labelFormatter: (value) => dayjs(value).format("MMM"),
    }}
    xAxisProps={{
      dataKey: "date",
      tickFormatter: (value) => dayjs(value).format("MMM"),
    }}
  />
)

Add Unit

To add a unit, use formatter or tickFormatter or set unit to a string.

const series = useMemo<BarChart.BarProps<Data>[]>(
  () => BarChart.mergeSeries([{ dataKey: "desktop" }]),
  [],
)
const data = useMemo(() => createCartesianChartData(), [])

return (
  <BarChart.Root
    data={data}
    series={series}
    withYAxis
    barProps={{
      label: {
        formatter: (value) => `${(Number(value) / 1000).toFixed(1)}k`,
      },
    }}
    chartProps={{ margin: { right: 16 } }}
    tooltipProps={{
      formatter: (value) => `${(Number(value) / 1000).toFixed(1)}k`,
      labelFormatter: (value) => dayjs(value).format("MMM"),
    }}
    xAxisProps={{
      dataKey: "date",
      tickFormatter: (value) => dayjs(value).format("MMM"),
    }}
    yAxisProps={{
      domain: [0, 10000],
      tickFormatter: (value) => (value / 1000).toFixed(1),
      ticks: [0, 2500, 5000, 7500, 10000],
      unit: "k",
    }}
  />
)

Vertical

To make the chart vertical, set layout to "vertical" in chartProps and adjust the type of the axes.

const series = useMemo<BarChart.BarProps<Data>[]>(
  () =>
    BarChart.mergeSeries([
      { dataKey: "desktop" },
      { dataKey: "tablet" },
      { dataKey: "mobile" },
    ]),
  [],
)
const data = useMemo(() => createCartesianChartData(), [])

return (
  <BarChart.Root
    data={data}
    series={series}
    withYAxis
    chartProps={{ layout: "vertical" }}
    tooltipProps={{
      labelFormatter: (value) => dayjs(value).format("MMM"),
    }}
    xAxisProps={{ type: "number" }}
    yAxisProps={{
      type: "category",
      dataKey: "date",
      tickFormatter: (value) => dayjs(value).format("MMM"),
    }}
  />
)

Sync

To sync the chart, set syncId to a string.

const series = useMemo<BarChart.BarProps<Data>[]>(
  () =>
    BarChart.mergeSeries([
      { dataKey: "desktop" },
      { dataKey: "tablet" },
      { dataKey: "mobile" },
    ]),
  [],
)
const data = useMemo(() => createCartesianChartData(), [])

return (
  <VStack>
    <BarChart.Root
      data={data}
      series={series}
      syncId="chart"
      tooltipProps={{
        labelFormatter: (value) => dayjs(value).format("MMM"),
      }}
      xAxisProps={{
        dataKey: "date",
        tickFormatter: (value) => dayjs(value).format("MMM"),
      }}
    />
    <BarChart.Root
      data={data}
      series={series}
      syncId="chart"
      tooltipProps={{
        labelFormatter: (value) => dayjs(value).format("MMM"),
      }}
      xAxisProps={{
        dataKey: "date",
        tickFormatter: (value) => dayjs(value).format("MMM"),
      }}
    />
  </VStack>
)

Format

To format the chart, use formatter or tickFormatter etc.

const series = useMemo<BarChart.BarProps<Data>[]>(
  () =>
    BarChart.mergeSeries([
      { dataKey: "desktop" },
      { dataKey: "tablet" },
      { dataKey: "mobile" },
    ]),
  [],
)
const data = useMemo(() => createCartesianChartData(), [])

return (
  <BarChart.Root
    data={data}
    series={series}
    withYAxis
    chartProps={{ margin: { right: 16 } }}
    tooltipProps={{
      formatter: (value, name = "") => [
        Number(value).toLocaleString(),
        toTitleCase(name),
      ],
      labelFormatter: (value) => dayjs(value).format("MMM"),
    }}
    xAxisProps={{
      dataKey: "date",
      tickFormatter: (value) => dayjs(value).format("MMM"),
    }}
    yAxisProps={{ tickFormatter: (value) => value.toLocaleString() }}
  />
)

Add Reference Line

const series = useMemo<BarChart.BarProps<Data>[]>(
  () =>
    BarChart.mergeSeries([
      { dataKey: "desktop" },
      { dataKey: "tablet" },
      { dataKey: "mobile" },
    ]),
  [],
)
const data = useMemo(() => createCartesianChartData(), [])

return (
  <BarChart.Root
    data={data}
    series={series}
    tooltipProps={{
      labelFormatter: (value) => dayjs(value).format("MMM"),
    }}
    xAxisProps={{
      dataKey: "date",
      tickFormatter: (value) => dayjs(value).format("MMM"),
    }}
  >
    <BarChart.ReferenceLine label="Reference line" y={3000} />
    <BarChart.ReferenceLine
      label={{ position: "insideTopLeft", value: "Reference line" }}
      x={dayjs().add(3, "month").format("YYYY-MM-DD")}
    />
    <BarChart.ReferenceLine
      label={{ position: "center", value: "Reference line" }}
      segment={[
        { x: dayjs().format("YYYY-MM-DD"), y: 0 },
        { x: dayjs().add(3, "month").format("YYYY-MM-DD"), y: 3000 },
      ]}
    />
  </BarChart.Root>
)

Add Tick Line

To add a reference line, set tickLine to true in xAxisProps or yAxisProps. The default is false.

const series = useMemo<BarChart.BarProps<Data>[]>(
  () =>
    BarChart.mergeSeries([
      { dataKey: "desktop" },
      { dataKey: "tablet" },
      { dataKey: "mobile" },
    ]),
  [],
)
const data = useMemo(() => createCartesianChartData(), [])

return (
  <BarChart.Root
    data={data}
    series={series}
    withYAxis
    chartProps={{ margin: { right: 16 } }}
    tooltipProps={{
      labelFormatter: (value) => dayjs(value).format("MMM"),
    }}
    xAxisProps={{
      dataKey: "date",
      tickFormatter: (value) => dayjs(value).format("MMM"),
      tickLine: true,
    }}
    yAxisProps={{ tickLine: true }}
  />
)

Add Axis Label

To add an axis label, set label to a string in xAxisProps or yAxisProps. The default is false.

const series = useMemo<BarChart.BarProps<Data>[]>(
  () =>
    BarChart.mergeSeries([
      { dataKey: "desktop" },
      { dataKey: "tablet" },
      { dataKey: "mobile" },
    ]),
  [],
)
const data = useMemo(() => createCartesianChartData(), [])

return (
  <BarChart.Root
    data={data}
    series={series}
    withYAxis
    chartProps={{ margin: { right: 16 } }}
    tooltipProps={{
      labelFormatter: (value) => dayjs(value).format("MMM"),
    }}
    xAxisProps={{
      dataKey: "date",
      label: "Date",
      tickFormatter: (value) => dayjs(value).format("MMM"),
    }}
    yAxisProps={{ label: "Value" }}
  />
)

Set Domain

To set the domain, set domain to an array in yAxisProps. To set the ticks, set ticks to an array in yAxisProps.

const series = useMemo<BarChart.BarProps<Data>[]>(
  () =>
    BarChart.mergeSeries([
      { dataKey: "desktop" },
      { dataKey: "tablet" },
      { dataKey: "mobile" },
    ]),
  [],
)
const data = useMemo(() => createCartesianChartData(), [])

return (
  <BarChart.Root
    data={data}
    series={series}
    withYAxis
    chartProps={{ margin: { right: 16 } }}
    tooltipProps={{
      labelFormatter: (value) => dayjs(value).format("MMM"),
    }}
    xAxisProps={{
      dataKey: "date",
      tickFormatter: (value) => dayjs(value).format("MMM"),
    }}
    yAxisProps={{
      domain: [0, 5000],
      ticks: [0, 1000, 2000, 3000, 4000, 5000],
    }}
  />
)

Change Gap

To change the gap, set barCategoryGap and barGap in chartProps to a number or string.

const series = useMemo<BarChart.BarProps<Data>[]>(
  () =>
    BarChart.mergeSeries([
      { dataKey: "desktop" },
      { dataKey: "tablet" },
      { dataKey: "mobile" },
    ]),
  [],
)
const data = useMemo(() => createCartesianChartData(), [])

return (
  <BarChart.Root
    data={data}
    series={series}
    chartProps={{ barCategoryGap: 16, barGap: 8 }}
    tooltipProps={{
      labelFormatter: (value) => dayjs(value).format("MMM"),
    }}
    xAxisProps={{
      dataKey: "date",
      tickFormatter: (value) => dayjs(value).format("MMM"),
    }}
  />
)

Change Radius

To change the radius, set radius in series or barProps.radius to a number or an array.

const series = useMemo<BarChart.BarProps<Data>[]>(
  () => [
    { color: "red", dataKey: "desktop", radius: 8 },
    {
      color: "blue",
      dataKey: "tablet",
      radius: [0, 0, 8, 8],
      stackId: "stack",
    },
    {
      color: "green",
      dataKey: "mobile",
      radius: [8, 8, 0, 0],
      stackId: "stack",
    },
  ],
  [],
)
const data = useMemo(() => createCartesianChartData(), [])

return (
  <BarChart.Root
    data={data}
    series={series}
    tooltipProps={{
      labelFormatter: (value) => dayjs(value).format("MMM"),
    }}
    xAxisProps={{
      dataKey: "date",
      tickFormatter: (value) => dayjs(value).format("MMM"),
    }}
  />
)

To add a tooltip cursor, set cursor to true in tooltipProps. The default is false.

const series = useMemo<BarChart.BarProps<Data>[]>(
  () =>
    BarChart.mergeSeries([
      { dataKey: "desktop" },
      { dataKey: "tablet" },
      { dataKey: "mobile" },
    ]),
  [],
)
const data = useMemo(() => createCartesianChartData(), [])

return (
  <BarChart.Root
    data={data}
    series={series}
    tooltipProps={{
      cursor: true,
      labelFormatter: (value) => dayjs(value).format("MMM"),
    }}
    xAxisProps={{
      dataKey: "date",
      tickFormatter: (value) => dayjs(value).format("MMM"),
    }}
  />
)

Hide X Axis

To hide the X axis, set withXAxis to false. The default is true.

const series = useMemo<BarChart.BarProps<Data>[]>(
  () =>
    BarChart.mergeSeries([
      { dataKey: "desktop" },
      { dataKey: "tablet" },
      { dataKey: "mobile" },
    ]),
  [],
)
const data = useMemo(() => createCartesianChartData(), [])

return (
  <BarChart.Root
    data={data}
    series={series}
    withXAxis={false}
    chartProps={{ margin: { left: 0, right: 0 } }}
    tooltipProps={{ labelFormatter: () => null }}
  />
)

To hide the tooltip, set withTooltip to false. The default is true.

const series = useMemo<BarChart.BarProps<Data>[]>(
  () =>
    BarChart.mergeSeries([
      { dataKey: "desktop" },
      { dataKey: "tablet" },
      { dataKey: "mobile" },
    ]),
  [],
)
const data = useMemo(() => createCartesianChartData(), [])

return (
  <BarChart.Root
    data={data}
    series={series}
    withTooltip={false}
    xAxisProps={{
      dataKey: "date",
      tickFormatter: (value) => dayjs(value).format("MMM"),
    }}
  />
)

Customize Axis

const series = useMemo<BarChart.BarProps<Data>[]>(
  () =>
    BarChart.mergeSeries([
      { dataKey: "desktop" },
      { dataKey: "tablet" },
      { dataKey: "mobile" },
    ]),
  [],
)
const data = useMemo(() => createCartesianChartData(), [])

return (
  <BarChart.Root
    data={data}
    series={series}
    withYAxis
    chartProps={{ margin: { right: 16 } }}
    tooltipProps={{
      labelFormatter: (value) => dayjs(value).format("MMM"),
    }}
    xAxisProps={{
      dataKey: "date",
      label: { color: ["red", "blue"] },
      tick: { color: ["red", "blue"] },
      tickFormatter: (value) => dayjs(value).format("MMM"),
      tickLine: { color: ["red", "blue"] },
    }}
    yAxisProps={{
      label: { color: ["red", "blue"] },
      tick: { color: ["red", "blue"] },
      tickLine: { color: ["red", "blue"] },
    }}
  />
)

Customize Label

const series = useMemo<BarChart.BarProps<Data>[]>(
  () => [{ color: "blue", dataKey: "desktop" }],
  [],
)
const data = useMemo(() => createCartesianChartData(), [])

return (
  <BarChart.Root
    data={data}
    series={series}
    barProps={{
      label: { color: "red" },
    }}
    tooltipProps={{
      labelFormatter: (value) => dayjs(value).format("MMM"),
      contentProps: { withSwatch: false },
    }}
    xAxisProps={{
      dataKey: "date",
      tickFormatter: (value) => dayjs(value).format("MMM"),
    }}
    yAxisProps={{
      domain: [0, 10000],
      ticks: [0, 2500, 5000, 7500, 10000],
    }}
  />
)

Customize Grid

const series = useMemo<BarChart.BarProps<Data>[]>(
  () =>
    BarChart.mergeSeries([
      { dataKey: "desktop" },
      { dataKey: "tablet" },
      { dataKey: "mobile" },
    ]),
  [],
)
const data = useMemo(() => createCartesianChartData(), [])

return (
  <BarChart.Root
    data={data}
    series={series}
    gridProps={{ strokeDasharray: "15 15" }}
    tooltipProps={{
      labelFormatter: (value) => dayjs(value).format("MMM"),
      contentProps: { withSwatch: false },
    }}
    xAxisProps={{
      dataKey: "date",
      tickFormatter: (value) => dayjs(value).format("MMM"),
    }}
  />
)

const series = useMemo<BarChart.BarProps<Data>[]>(
  () =>
    BarChart.mergeSeries([
      { dataKey: "desktop" },
      { dataKey: "tablet" },
      { dataKey: "mobile" },
    ]),
  [],
)
const data = useMemo(() => createCartesianChartData(), [])

return (
  <BarChart.Root
    data={data}
    series={series}
    tooltipProps={{
      cursor: { fill: "red", fillOpacity: 0.2 },
      labelFormatter: (value) => dayjs(value).format("MMM"),
    }}
    xAxisProps={{
      dataKey: "date",
      tickFormatter: (value) => dayjs(value).format("MMM"),
    }}
  />
)

Props

BarChart.Root

Prop	Default	Type / Description
`as`	-	`As` The HTML element to render.
`asChild`	-	`boolean` Merges its props onto its immediate child.
`css`	-	`CSSObject \| CSSObject[]` The CSS object.
`colorScheme`	-	`"amber" \| "black" \| "blackAlpha" \| "blue" \| "cyan" \| "danger" \| "emerald" \| "error" \| "flashy" \| "fuchsia" ...` Set color scheme variables.
`size`	-	`"lg" \| "md" \| "sm" \| "xl" \| "xs"` The size of the component.
`activeDotFill`	-	`"-moz-initial" \| "AccentColor" \| "AccentColorText" \| "ActiveBorder" \| "ActiveCaption" \| "ActiveText" \| "aliceblue" \| "amber.100" \| "amber.200" \| "amber.300" ...` The fill color of the active dots.
`activeDotRadius`	-	`"-moz-initial" \| "inherit" \| "initial" \| "revert-layer" \| "revert" \| "unset" \| 0 ...` The radius of the active dots.
`activeDotStroke`	-	`"-moz-initial" \| "AccentColor" \| "AccentColorText" \| "ActiveBorder" \| "ActiveCaption" \| "ActiveText" \| "aliceblue" \| "amber.100" \| "amber.200" \| "amber.300" ...` The stroke color of the active dots.
`activeDotStrokeWidth`	-	`"-moz-initial" \| "inherit" \| "initial" \| "revert-layer" \| "revert" \| "unset" \| number \| number & {} ...` The stroke width of the active dots.
`areaEndFillOpacity`	-	`"-moz-initial" \| "inherit" \| "initial" \| "revert-layer" \| "revert" \| "unset" \| number & {} ...` The fill opacity of the area end.
`areaFillOpacity`	-	`"-moz-initial" \| "inherit" \| "initial" \| "revert-layer" \| "revert" \| "unset" \| number & {} ...` The fill opacity of the area.
`areaProps`	-	`Omit<ChartAreaProps<Dict<any>>, "data" \| "dataKey">` Props for the area component.
`areaStartFillOpacity`	-	`"-moz-initial" \| "inherit" \| "initial" \| "revert-layer" \| "revert" \| "unset" \| number & {} ...` The fill opacity of the area start.
`barColor`	-	`"-moz-initial" \| "AccentColor" \| "AccentColorText" \| "ActiveBorder" \| "ActiveCaption" \| "ActiveText" \| "aliceblue" \| "amber.100" \| "amber.200" \| "amber.300" ...` The color of the bars.
`barFill`	-	`"-moz-initial" \| "AccentColor" \| "AccentColorText" \| "ActiveBorder" \| "ActiveCaption" \| "ActiveText" \| "aliceblue" \| "amber.100" \| "amber.200" \| "amber.300" ...` The fill color of the bars.
`barFillOpacity`	-	`"-moz-initial" \| "inherit" \| "initial" \| "revert-layer" \| "revert" \| "unset" \| number & {} ...` The fill opacity of the bars.
`barProps`	-	`Omit<ChartBarProps<Dict<any>>, "dataKey">` Props for the bar component.
`barStroke`	-	`"-moz-initial" \| "AccentColor" \| "AccentColorText" \| "ActiveBorder" \| "ActiveCaption" \| "ActiveText" \| "aliceblue" \| "amber.100" \| "amber.200" \| "amber.300" ...` The stroke color of the bars.
`barStrokeWidth`	-	`"-moz-initial" \| "inherit" \| "initial" \| "revert-layer" \| "revert" \| "unset" \| number \| number & {} ...` The stroke width of the bars.
`chartProps`	-	`Omit<CartesianChartProps, "data">` Props for the line chart component.
`data`	-	`Y[]` Chart data.
`dotFill`	-	`"-moz-initial" \| "AccentColor" \| "AccentColorText" \| "ActiveBorder" \| "ActiveCaption" \| "ActiveText" \| "aliceblue" \| "amber.100" \| "amber.200" \| "amber.300" ...` The fill color of the dots.
`dotRadius`	-	`"-moz-initial" \| "inherit" \| "initial" \| "revert-layer" \| "revert" \| "unset" \| 0 ...` The radius of the dots.
`dotStroke`	-	`"-moz-initial" \| "AccentColor" \| "AccentColorText" \| "ActiveBorder" \| "ActiveCaption" \| "ActiveText" \| "aliceblue" \| "amber.100" \| "amber.200" \| "amber.300" ...` The stroke color of the dots.
`dotStrokeWidth`	-	`"-moz-initial" \| "inherit" \| "initial" \| "revert-layer" \| "revert" \| "unset" \| number \| number & {} ...` The stroke width of the dots.
`gridProps`	-	`ChartGridProps` Props for the grid component.
`gridStroke`	-	`"-moz-initial" \| "AccentColor" \| "AccentColorText" \| "ActiveBorder" \| "ActiveCaption" \| "ActiveText" \| "aliceblue" \| "amber.100" \| "amber.200" \| "amber.300" ...` The stroke color of the grid.
`inactiveBarOpacity`	-	`"-moz-initial" \| "inherit" \| "initial" \| "revert-layer" \| "revert" \| "unset" \| number & {} ...` The opacity of the inactive bars.
`inactiveLineOpacity`	-	`"-moz-initial" \| "inherit" \| "initial" \| "revert-layer" \| "revert" \| "unset" \| number & {} ...` The opacity of the inactive lines.
`labelListColor`	-	`"-moz-initial" \| "AccentColor" \| "AccentColorText" \| "ActiveBorder" \| "ActiveCaption" \| "ActiveText" \| "aliceblue" \| "amber.100" \| "amber.200" \| "amber.300" ...` The color of the label list.
`labelListFill`	-	`"-moz-initial" \| "AccentColor" \| "AccentColorText" \| "ActiveBorder" \| "ActiveCaption" \| "ActiveText" \| "aliceblue" \| "amber.100" \| "amber.200" \| "amber.300" ...` The fill of the label list.
`legendProps`	-	`ChartLegendProps` Props for the legend component.
`lineColor`	-	`"-moz-initial" \| "AccentColor" \| "AccentColorText" \| "ActiveBorder" \| "ActiveCaption" \| "ActiveText" \| "aliceblue" \| "amber.100" \| "amber.200" \| "amber.300" ...` The color of the lines.
`lineProps`	-	`Omit<ChartLineProps<Dict<any>>, "data" \| "dataKey">` Props for the line component.
`lineStroke`	-	`"-moz-initial" \| "AccentColor" \| "AccentColorText" \| "ActiveBorder" \| "ActiveCaption" \| "ActiveText" \| "aliceblue" \| "amber.100" \| "amber.200" \| "amber.300" ...` The stroke color of the lines.
`lineStrokeWidth`	-	`"-moz-initial" \| "inherit" \| "initial" \| "revert-layer" \| "revert" \| "unset" \| number \| number & {} ...` The stroke width of the lines.
`referenceLineColor`	-	`"-moz-initial" \| "AccentColor" \| "AccentColorText" \| "ActiveBorder" \| "ActiveCaption" \| "ActiveText" \| "aliceblue" \| "amber.100" \| "amber.200" \| "amber.300" ...` The color of the reference lines.
`referenceLineProps`	-	`ChartReferenceLineProps` Props for the reference line component.
`referenceLineStroke`	-	`"-moz-initial" \| "AccentColor" \| "AccentColorText" \| "ActiveBorder" \| "ActiveCaption" \| "ActiveText" \| "aliceblue" \| "amber.100" \| "amber.200" \| "amber.300" ...` The stroke color of the reference lines.
`referenceLineStrokeWidth`	-	`"-moz-initial" \| "inherit" \| "initial" \| "revert-layer" \| "revert" \| "unset" \| number \| number & {} ...` The stroke width of the reference lines.
`referenceLineTextColor`	-	`"-moz-initial" \| "AccentColor" \| "AccentColorText" \| "ActiveBorder" \| "ActiveCaption" \| "ActiveText" \| "aliceblue" \| "amber.100" \| "amber.200" \| "amber.300" ...` The text color of the reference lines.
`referenceLineTextFill`	-	`"-moz-initial" \| "AccentColor" \| "AccentColorText" \| "ActiveBorder" \| "ActiveCaption" \| "ActiveText" \| "aliceblue" \| "amber.100" \| "amber.200" \| "amber.300" ...` The text fill color of the reference lines.
`responsiveContainerProps`	-	`Props` Props for the responsive container component.
`series`	-	`ChartBarProps<Y>[]` - If provided, generate bars based on series.
`tooltipCursorFill`	-	`"-moz-initial" \| "AccentColor" \| "AccentColorText" \| "ActiveBorder" \| "ActiveCaption" \| "ActiveText" \| "aliceblue" \| "amber.100" \| "amber.200" \| "amber.300" ...` The fill of the tooltip cursor.
`tooltipCursorFillOpacity`	-	`"-moz-initial" \| "inherit" \| "initial" \| "revert-layer" \| "revert" \| "unset" \| number & {} ...` The fill opacity of the tooltip cursor.
`tooltipCursorStroke`	-	`"-moz-initial" \| "AccentColor" \| "AccentColorText" \| "ActiveBorder" \| "ActiveCaption" \| "ActiveText" \| "aliceblue" \| "amber.100" \| "amber.200" \| "amber.300" ...` The stroke of the tooltip cursor.
`tooltipProps`	-	`ChartTooltipProps<number, string>` Props for the tooltip component.
`withGrid`	`true`	`boolean` If `true`, grid is visible.
`withLegend`	`false`	`boolean` If `true`, legend is visible.
`withTooltip`	`true`	`boolean` If `true`, tooltip is visible.
`withXAxis`	`true`	`boolean` If `true`, X axis is visible.
`withYAxis`	`false`	`boolean` If `true`, Y axis is visible.
`xAxisLineStroke`	-	`"-moz-initial" \| "AccentColor" \| "AccentColorText" \| "ActiveBorder" \| "ActiveCaption" \| "ActiveText" \| "aliceblue" \| "amber.100" \| "amber.200" \| "amber.300" ...` The stroke color of the x-axis lines.
`xAxisLineStrokeWidth`	-	`"-moz-initial" \| "inherit" \| "initial" \| "revert-layer" \| "revert" \| "unset" \| number \| number & {} ...` The stroke width of the x-axis lines.
`xAxisProps`	-	`ChartXAxisProps` Props for the x axis component.
`xAxisTextColor`	-	`"-moz-initial" \| "AccentColor" \| "AccentColorText" \| "ActiveBorder" \| "ActiveCaption" \| "ActiveText" \| "aliceblue" \| "amber.100" \| "amber.200" \| "amber.300" ...` The text color of the x-axis.
`xAxisTextFill`	-	`"-moz-initial" \| "AccentColor" \| "AccentColorText" \| "ActiveBorder" \| "ActiveCaption" \| "ActiveText" \| "aliceblue" \| "amber.100" \| "amber.200" \| "amber.300" ...` The text fill color of the x-axis.
`yAxisLineStroke`	-	`"-moz-initial" \| "AccentColor" \| "AccentColorText" \| "ActiveBorder" \| "ActiveCaption" \| "ActiveText" \| "aliceblue" \| "amber.100" \| "amber.200" \| "amber.300" ...` The stroke color of the y-axis lines.
`yAxisLineStrokeWidth`	-	`"-moz-initial" \| "inherit" \| "initial" \| "revert-layer" \| "revert" \| "unset" \| number \| number & {} ...` The stroke width of the y-axis lines.
`yAxisProps`	-	`ChartYAxisProps` Props for the y axis component.
`yAxisTextColor`	-	`"-moz-initial" \| "AccentColor" \| "AccentColorText" \| "ActiveBorder" \| "ActiveCaption" \| "ActiveText" \| "aliceblue" \| "amber.100" \| "amber.200" \| "amber.300" ...` The text color of the y-axis.
`yAxisTextFill`	-	`"-moz-initial" \| "AccentColor" \| "AccentColorText" \| "ActiveBorder" \| "ActiveCaption" \| "ActiveText" \| "aliceblue" \| "amber.100" \| "amber.200" \| "amber.300" ...` The text fill color of the y-axis.

BarChart.Bar

Prop	Default	Type / Description
`as`	-	`As` The HTML element to render.
`asChild`	-	`boolean` Merges its props onto its immediate child.
`css`	-	`CSSObject \| CSSObject[]` The CSS object.
`colorScheme`	-	`"amber" \| "black" \| "blackAlpha" \| "blue" \| "cyan" \| "danger" \| "emerald" \| "error" \| "flashy" \| "fuchsia" ...` Set color scheme variables.
`dataKey`	-	`keyof Y` The key of a group of data which should be unique in an chart.
`label`	`false`	`ChartLabelList` The label list to use for the bar.

BarChart.Grid

Prop	Default	Type / Description
`as`	-	`As` The HTML element to render.
`asChild`	-	`boolean` Merges its props onto its immediate child.
`css`	-	`CSSObject \| CSSObject[]` The CSS object.
`colorScheme`	-	`"amber" \| "black" \| "blackAlpha" \| "blue" \| "cyan" \| "danger" \| "emerald" \| "error" \| "flashy" \| "fuchsia" ...` Set color scheme variables.

BarChart.Label

Prop	Default	Type / Description
`as`	-	`As` The HTML element to render.
`asChild`	-	`boolean` Merges its props onto its immediate child.
`css`	-	`CSSObject \| CSSObject[]` The CSS object.
`colorScheme`	-	`"amber" \| "black" \| "blackAlpha" \| "blue" \| "cyan" \| "danger" \| "emerald" \| "error" \| "flashy" \| "fuchsia" ...` Set color scheme variables.

BarChart.LabelList

Prop	Default	Type / Description
`as`	-	`As` The HTML element to render.
`asChild`	-	`boolean` Merges its props onto its immediate child.
`css`	-	`CSSObject \| CSSObject[]` The CSS object.
`colorScheme`	-	`"amber" \| "black" \| "blackAlpha" \| "blue" \| "cyan" \| "danger" \| "emerald" \| "error" \| "flashy" \| "fuchsia" ...` Set color scheme variables.

BarChart.Legend

Prop	Default	Type / Description
`as`	-	`As` The HTML element to render.
`asChild`	-	`boolean` Merges its props onto its immediate child.
`css`	-	`CSSObject \| CSSObject[]` The CSS object.
`colorScheme`	-	`"amber" \| "black" \| "blackAlpha" \| "blue" \| "cyan" \| "danger" \| "emerald" \| "error" \| "flashy" \| "fuchsia" ...` Set color scheme variables.
`contentProps`	-	`Omit<ChartLegendContentProps, "formatter" \| "payload">` Props for the content component.
`placement`	`"start-end"`	`Direction` The placement of the legend.

BarChart.ReferenceLine

Prop	Default	Type / Description
`as`	-	`As` The HTML element to render.
`asChild`	-	`boolean` Merges its props onto its immediate child.
`css`	-	`CSSObject \| CSSObject[]` The CSS object.
`colorScheme`	-	`"amber" \| "black" \| "blackAlpha" \| "blue" \| "cyan" \| "danger" \| "emerald" \| "error" \| "flashy" \| "fuchsia" ...` Set color scheme variables.
`label`	`false`	`ChartLabel` The label to use for the reference line.

BarChart.Tooltip

Prop	Default	Type / Description
`as`	-	`As` The HTML element to render.
`asChild`	-	`boolean` Merges its props onto its immediate child.
`css`	-	`CSSObject \| CSSObject[]` The CSS object.
`colorScheme`	-	`"amber" \| "black" \| "blackAlpha" \| "blue" \| "cyan" \| "danger" \| "emerald" \| "error" \| "flashy" \| "fuchsia" ...` Set color scheme variables.
`contentProps`	-	`Omit<ChartTooltipContentProps, "formatter" \| "label" \| "labelFormatter" \| "payload">` Props for the content component.
`cursor`	-	`boolean \| ChartTooltipCursorProps \| ReactElement` Props for the cursor component.

BarChart.XAxis

Prop	Default	Type / Description
`as`	-	`As` The HTML element to render.
`asChild`	-	`boolean` Merges its props onto its immediate child.
`css`	-	`CSSObject \| CSSObject[]` The CSS object.
`colorScheme`	-	`"amber" \| "black" \| "blackAlpha" \| "blue" \| "cyan" \| "danger" \| "emerald" \| "error" \| "flashy" \| "fuchsia" ...` Set color scheme variables.
`label`	`false`	`ChartLabel` The label to use for the axis.
`tick`	`true`	`ChartXAxisTick` The tick to use for the axis.
`tickLine`	`false`	`ChartTickLine` The tick line to use for the axis.

BarChart.YAxis

Prop	Default	Type / Description
`as`	-	`As` The HTML element to render.
`asChild`	-	`boolean` Merges its props onto its immediate child.
`css`	-	`CSSObject \| CSSObject[]` The CSS object.
`colorScheme`	-	`"amber" \| "black" \| "blackAlpha" \| "blue" \| "cyan" \| "danger" \| "emerald" \| "error" \| "flashy" \| "fuchsia" ...` Set color scheme variables.
`label`	`false`	`ChartLabel` The label to use for the axis.
`orientation`	-	`SimpleDirection` The orientation of axis.
`tick`	`true`	`ChartYAxisTick` The tick to use for the axis.
`tickLine`	`false`	`ChartTickLine` The tick line to use for the axis.