Skip to main content

Example

{% pie_chart
    data="demo_daily_orders"
    category="category"
    value="sum(total_sales)"
/%}

With Custom Colors

{% pie_chart
    data="demo_daily_orders"
    category="category"
    value="sum(total_sales)"
    title="Sales by Category"
    chart_options={
        color_palette = ["#0d0887", "#6300a7", "#a62098", "#d5546e", "#f68d45", "#fcd225", "#f0f921"]
    }
/%}

Attributes

data
String
required
Name of the table to query
filters
Array
default:"[]"
Array of column names to use as filters
date_range
Use date_range to filter data for specific time periods. Accepts predefined ranges (e.g., “last 12 months”), dynamic ranges (e.g., “Last 90 days”), custom date ranges (e.g., “2020-01-01 to 2023-03-01”), or partial ranges (e.g., “from 2020-01-01”, “until 2023-03-01”)Example:
date_range={
  range = value
  date = "string"
}
Attributes:
  • range: enum
  • date: string
category
String
required
Column name for categories (pie slices)
value
String
required
Column name for values (slice sizes)
title
String
Title to display above the chart
subtitle
String
Subtitle to display below the title
info
String
Info text to display in a tooltip next to the title. Can only be used with the title prop.
inner_radius
String
default:"40%"
Inner radius of the pie (use 0% for full pie, >0% for donut style)
value_fmt
String
default:"num"
Format for values
legend
Boolean
default:"false"
Show legend instead of slice labels
chart_options
default:"{}"
Chart configuration optionsExample:
chart_options={
  color_palette = []
}
Attributes:
  • color_palette: array
where
String
Custom SQL WHERE condition to apply to the query. For date filters, use date_range instead.
having
String
Custom SQL HAVING condition to apply to the query after GROUP BY
limit
Number
Maximum number of rows to return from the query
order
String
Column name(s) with optional direction (e.g. “column_name”, “column_name desc”)
qualify
String
Custom SQL QUALIFY condition to filter windowed results
width
Number
Set the width of this component (in percent) relative to the page width
I