--- title: "Configure Pie or Donut Chart" slug: "configure-pie-or-donut-chart" updated: 2026-02-03T14:45:09Z published: 2026-02-03T14:45:09Z canonical: "skthelp.syniti.com/configure-pie-or-donut-chart" --- > ## Documentation Index > Fetch the complete documentation index at: https://skthelp.syniti.com/llms.txt > Use this file to discover all available pages before exploring further. # Configure Pie or Donut Chart ## Overview This article helps you configure Pie or Donut chart using the components available in the WebApp Builder. This chart is ideal for displaying proportional relationships, percentage-based comparisons, or resource allocations. ### Prerequisites - Review the [recommendations](/docs/configure-pie-or-donut-chart#dataset-design-recommendations) provided to design/create a chart dataset. - Ensure that a [Dataset](/v1/docs/datasets) is created for the appropriate chart type and purpose, using the required fields. - When cleansing or enriching data, users may want to visualize their work with charts. In this case, create a Grid or Form container on a construct page and use the same dataset to bind data between the Grid or Form and the Chart containers. **For example**, you are cleansing customer records in a Grid container by correcting missing or invalid values. You can then use the same dataset in a Chart container to visualize customer distribution by region. Since both the Grid and Chart share the same dataset, any changes in the Grid are automatically reflected in the Chart. ## Dataset Design Recommendations - Not ideal for grouped data. - Requires two columns from a dataset. > [!NOTE] > Note > > You can use the same chart dataset in a Grid component if you plan to modify or manipulate the data. - Ensure that the Value Field property is assigned to a column with a NUMERIC(precision, scale) data type in your dataset. - You need to include an additional field in your dataset if you plan to bind the chart dataset to a grid or form component’s dataset. Refer to [Data Binding in Charts](/v1/docs/data-binding-in-charts) for more information. ### Pie or Donut Chart Example Sample DatasetConfigurationRendered Chart Pie Chart Configuration ![](https://cdn.document360.io/ca09b4e9-1857-4c63-9f0e-1f25f166f447/Images/Documentation/image(866).png?sv=2026-02-06&spr=https&st=2026-11-17T19%3A53%3A31Z&se=2026-11-17T20%3A53%3A31Z&sr=b&sp=r&sig=NTQSwOvXirPvSwfmub9YT4wzxD2A7XHftoQMgzxku2k%3D) Donut Chart Configuration ![](https://cdn.document360.io/ca09b4e9-1857-4c63-9f0e-1f25f166f447/Images/Documentation/image(895).png?sv=2026-02-06&spr=https&st=2026-11-17T19%3A53%3A31Z&se=2026-11-17T20%3A53%3A31Z&sr=b&sp=r&sig=p%2BzHztSL0g5vq0zZCK6Wj%2FQmyo%2FK7%2FlggKgLsY%2ByMD4%3D) ![](https://cdn.document360.io/ca09b4e9-1857-4c63-9f0e-1f25f166f447/Images/Documentation/image-1760621598186.png?sv=2026-02-06&spr=https&st=2026-11-17T19%3A53%3A31Z&se=2026-11-17T20%3A53%3A31Z&sr=b&sp=r&sig=5iDKPo7fOrl0e%2FBegcohS7qMrsDcPdf5mLjgQXM5B9Q%3D) ![](https://cdn.document360.io/ca09b4e9-1857-4c63-9f0e-1f25f166f447/Images/Documentation/image(868).png?sv=2026-02-06&spr=https&st=2026-11-17T19%3A53%3A31Z&se=2026-11-17T20%3A53%3A31Z&sr=b&sp=r&sig=7aqqsRa4m3ZMOHN7PVAPtqG6Oy12Jf4hg4r714AMXCo%3D) Pie Chart ![](https://cdn.document360.io/ca09b4e9-1857-4c63-9f0e-1f25f166f447/Images/Documentation/image(869).png?sv=2026-02-06&spr=https&st=2026-11-17T19%3A53%3A31Z&se=2026-11-17T20%3A53%3A31Z&sr=b&sp=r&sig=1khR8ReSqES7as4A9RX%2FCPEvYQSdXNqmM98X8Tetpzo%3D) Donut Chart with Pad Angle 5, Inner Radius 0.5, and Legend enabled ## Configuration Steps > [!NOTE] > Note > > You can interact with Build Assist to quickly configure charts as required by entering a prompt that provides the context of the dataset and the fields to be used. 1. On the Cloud Construct’s home page, edit the required WebApp. The WebApp configuration page is displayed. 2. Click **More Options** (**…**) next to the required page or container node and select **Add Chart > Add Pie Chart**. 3. Click the Pie Chart node. The Details Pane is updated with the Pie Chart fields. 4. Enter the required values for the fields to create a Pie or Donut chart in a container using the following tables: | Field Name | Description | Supported Values/Notes | | --- | --- | --- | | Name ***required*** | Name of the Pie or Donut Chart Container. | Enter a name within length constraints. maxLength: 50 | | Title | Label that is displayed on the top of this chart container. | Enter a title within length constraints. maxLength: 50 | | Parent Layout Container | Name of the parent container used for page layout. Allows you to link child containers to a parent container. | Select the parent container to house this chart container. | | Ordinal | Allows ordering the containers. | Any integer. default: 0 | | Tab Label | Label displayed as the tab name for a container. Use this property only when a container needs to be included in a tab container. | Enter a name within length constraints. maxLength: 50 | | Override Datastore | SKP Datastore name for this component that overrides the datastore configured at the WebApp level. Refer to [**Datastores**](https://skthelp.syniti.com/v1/docs/datastores) for more information. Click the **Open Details** ![](https://cdn.document360.io/ca09b4e9-1857-4c63-9f0e-1f25f166f447/Images/Documentation/image(897).png?sv=2026-02-06&spr=https&st=2026-11-17T19%3A53%3A31Z&se=2026-11-17T20%3A53%3A31Z&sr=b&sp=r&sig=jmxwpmy6yovHypJs3ioKvI73dJfqJEwNpcIfB6P7x3g%3D) button next to the Datastore list to open it in the SKP Catalog. | NA | | Dataset ***required*** | SKP dataset for the data used for this container. Select the required Dataset. Scroll down the Dataset list to auto-create a dataset using a table or view based on Cloud Construct’s recommendation. > [!NOTE] > Note > > If a dataset is being created from a SQL view, you must set its **Affected Table**. Click the **Open Details** ![](https://cdn.document360.io/ca09b4e9-1857-4c63-9f0e-1f25f166f447/Images/Documentation/image(896).png?sv=2026-02-06&spr=https&st=2026-11-17T19%3A53%3A31Z&se=2026-11-17T20%3A53%3A31Z&sr=b&sp=r&sig=MJu94RzFrTf4cQbwCCUu94rlA2eJNFuKnWPk4Y3IPTU%3D) button next to the Dataset list to open it in the SKP Catalog. | > [!NOTE] > Note > > - The **Update Dataset** button opens a dialog box that allows you to rescan the dataset and add any newly available fields from the underlying table or view to the dataset used in this container. > - Specify the dataset classification. > - If the scan errors out, access the associated Datastore’s scan logs in the SKP Catalog module to troubleshoot the error. | | Label Field ***required*** | Select a field from the dataset used to render the labels. | NA | | Value Field ***required*** | Select a field from the dataset used to render numeric values in the chart. | NA | | Enable Arc Link Labels | Toggle this field to display labels next to the respective portions of the chart. | This toggle can be used instead of Legends. | | Legend | Toggle this field to display a legend on the chart. | This toggle can be used instead of Arc Link Labels. Selecting or deselecting a legend item will remove or add the corresponding data on the chart. | | Value Unit | Unit of measure that displays next to chart values. | Enter a name within length constraints. maxLength: 20 | | Inner Radius | Setting inner radius greater than 0 creates a Donut chart. | This field allows you to switch between Pie or Donut chart. minimum: 0, maximum: 0.95, default: 0 | | Pad Angle | Defines padding angle between portions of chart. | minimum: 0, maximum: 45, default: 1 | | Start Angle | Defines the starting angle of the chart. | minimum: -180, maximum: 360, default: 0 | | End Angle | Defines the ending angle of the chart. | minimum: -360, maximum: 360, default: 360 | | Parent Binding Container | Select the parent grid/form container type for data binding. Allows you to link between grids/forms and charts. | NA | | Container Bindings > Source Column | > [!NOTE] > Note > > Click **Add** to set up required number of container bindings. Select the source column in the parent binding container. | Use either the Source Column or the Source Value field, but not both. | | Container Bindings > Source Value | A fixed source value for data binding. | Use either the Source Column or the Source Value field, but not both. | | Container Bindings > Target Column ***required*** | Select the target column in the chart container’s dataset. | NA | | Columns > Name ***required*** | > [!NOTE] > Note > > Click **Add** to set up required number of columns to control how the fields on the chart will be sorted. Select the field name from the dataset used in the chart container. | NA | | Columns > Sort Mode | Used with the Sort Priority field to configure the default column sort order: | Supported Values: - None - Ascending - Descending | | Columns > Sort Priority | Used with the Sort Mode field to configure the default column sort order. | Default: 0 | | Link to Page Name | Select the Page to navigate on click. | NA | | Open in New Tab | Enable this toggle to open the chart link in a new browser tab. | NA | | Link to Page Bindings > Name ***required*** | > [!NOTE] > Note > > Click the **Add button** to add the required chart link to page bindings criteria. Specify a unique binding name for the page link | Enter a name for binding. maxLength: 256 | | Link to Page Bindings > Target Column ***required*** | Specify the target column in the linked page | Enter target column name from your dataset. maxLength: 128 | | Link to Page Bindings > Target Page Container Name | Specifies the container name in the linked page | Select the name of the grid or form container from the page you’ve selected. | | Link to Page Bindings > Source Data Record Field Value | Specifies the source column in the current page | Select source column name from your dataset. | | Link to Page Bindings > Fixed Value | Specifies the source value in the current page | Specify the value or the actual record of the source column. maxLength: 255 | | Display Mode | Configures the display mode | *** Card:** Card-like format *** Empty:** No visual elements Default: Card | | Layout | Specifies how the containers flow within the page | *** FlowHorizontal:** Side-by-side display *** FlowVertical:** Top-to-bottom display | | Alignment | Controls the alignment for placing the container | * Start * Stretch * End Default: Stretch | | Size | Value of the units that are used to compute the size of a container | Any positive number. minimum: 0, default: 1 | | Size Units | Units that are used to compute the size of a container | * Pixels * Rem * GrowRatio Default: GrowRatio | | Gap | The gap between containers or fields on a property card | Any positive number. minimum: 0, default: 1 | | Padding | Adjusts the padding inside of the container | Any positive number. minimum: 0, default: 0 | 5. Click the **Save & Preview** ![](https://cdn.document360.io/ca09b4e9-1857-4c63-9f0e-1f25f166f447/Images/Documentation/image(845).png?sv=2026-02-06&spr=https&st=2026-11-17T19%3A53%3A31Z&se=2026-11-17T20%3A53%3A31Z&sr=b&sp=r&sig=BVo0qZ8pjLQB4ZKtp4%2BwGyH8DkmlMnCd5wwd1rMWomU%3D) button to validate that the Pie or Donut chart is configured correctly. ## Related Articles - [Build Assist](/v1/docs/build-assist) - [Chart Types](/v1/docs/visualize-data-using-charts#chart-types) - [Data Binding in Charts](/v1/docs/data-binding-in-charts)