Pie and Doughnut Charts

These chart types belong to FusionCharts XT.

A pie chart is a circular chart divided into sectors where the arc length of each sector, its central angle, and its area is proportional to the quantity it represents. A doughnut chart is similar to a pie chart and facilities similar kind of data analysis. FusionCharts Suite XT includes the pie and doughnut charts to plot data that needs to be shown as a percent of the whole.

{ "header": "Chart Anatomy", "subHeader": "To know how FusionCharts works it is important to understand the various components and concepts of a chart", "content": { "header": "Below are different sections with interactive annotated images describing various components and concepts of charts", "contentGroup": [ { "_itemHeader": "Pie Chart Anatomy", "imgSrc": "pie-chart-anatomy.png", "annotations": [{ "annotationNumber": "1", "annotationName": "Caption", "annotationDesc": "The caption (also called the chart title) is the heading of your chart. You can add custom text for the caption, as well as configure its font properties and cosmetics. Learn more about it ", "annotationDescLinkPath": null, "leftPosition": "67.5%", "topPosition": "10%", "annotationLinks": [{ "linkDesc": "Learn how to add caption ", "linkPath": "/chart-guide/chart-configurations/caption-and-sub-caption#set-the-caption-and-subcaption" }, { "linkDesc": "Font properties and cosmetics of caption can also be customized using attributes. Know more about them ", "linkPath": "/chart-guide/chart-configurations/caption-and-sub-caption#customize-font-properties" }, { "linkDesc": "You can also customize the alignment of the caption. Learn more about it ", "linkPath": "/chart-guide/chart-configurations/caption-and-sub-caption#configure-caption-alignment" } ] }, { "annotationNumber": "2", "annotationName": "Subcaption", "annotationDesc": "The sub-caption (also called the chart subtitle) is the sub-heading of your chart. You can add custom text for sub-caption, as well as configure its font properties.", "annotationDescLinkPath": null, "leftPosition": "42.5%", "topPosition": "20.5%", "annotationLinks": [{ "linkDesc": "Learn how to add sub-caption ", "linkPath": "/chart-guide/chart-configurations/axes#setting-axes-names" }, { "linkDesc": "Font properties and cosmetics of sub-caption can also be customized using attributes. Learn more about them ", "linkPath": "/chart-guide/chart-configurations/caption-and-sub-caption#customize-font-properties" } ] }, { "annotationNumber": "3", "annotationName": "Data Plot", "annotationDesc": "Data plot refers to the pie/doughnut slices in a pie/doughnut chart, columns of the column chart, lines in a line chart.", "annotationDescLinkPath": null, "leftPosition": "40%", "topPosition": "38%", "annotationLinks": [{ "linkDesc": "You can customize the data plots. Learn more about it ", "linkPath": "/chart-guide/chart-configurations/data-plot" } ] }, { "annotationNumber": "4", "annotationName": "Data Labels", "annotationDesc": "Data labels refers to the labels associated with each pie slice. Learn more about it ", "annotationDescLinkPath": "/chart-guide/chart-configurations/data-labels", "leftPosition": "27%", "topPosition": "60%", "annotationLinks": [] }, { "annotationNumber": "5", "annotationName": "Data Values", "annotationDesc": "Data values refers to values associated with each pie slice. Learn more about it ", "annotationDescLinkPath": "/chart-guide/chart-configurations/data-values", "leftPosition": "70%", "topPosition": "68%", "annotationLinks": [] }, { "annotationNumber": "6", "annotationName": "Legend", "annotationDesc": "A legend is a chart element used to display the series name for each dataset, in case of multi-series or combination charts. Legends are used to correlate a data plot to its series name using its color. Learn more about them ", "annotationDescLinkPath": null, "leftPosition": "47.5%", "topPosition": "83.5%", "annotationLinks": [{ "linkDesc": "You can customize look and feel of legend like increase/decrease legend icon size, define custom legend icons, legend scroll etc. Learn more about it ", "linkPath": "/chart-guide/chart-configurations/legend#configure-legend-icon-size" }, { "linkDesc": "You can customize legend position on the chart either to right or bottom of the chart. Learn more about it ", "linkPath": "/chart-guide/chart-configurations/legend#set-the-legend-position" }, { "linkDesc": "You can highlight data plots by hovering over corresponding legend item using plot highlight effect feature, Learn more about it ", "linkPath": "/chart-guide/chart-configurations/legend#highlight-a-data-series-via-the-legend" } ] }, { "annotationNumber": "7", "annotationName": "Tooltip", "annotationDesc": "A tooltip is displayed when the mouse cursor hovers over a particular data point. It denotes valuable information about the data plot hovered.", "annotationDescLinkPath": "/chart-guide/chart-configurations/axes#setting-axes-names", "leftPosition": "64%", "topPosition": "38.5%", "annotationLinks": [{ "linkDesc": "You can customize padding, size and other properties of tooltip, learn more about it ", "linkPath": "/chart-guide/chart-configurations/tool-tips#customize-tooltips" }, { "linkDesc": "You can also customize the text of tooltip and use values plotted on the chart using macros, learn more about it ", "linkPath": "/chart-guide/chart-configurations/tool-tips#introduction-to-macros" } ] }, { "annotationNumber": "8", "annotationName": "Export Menu", "annotationDesc": "Export menu is hamburger menu that appears on top-right of the chart by hovering on which you can export the chart using available options.", "annotationDescLinkPath": null, "leftPosition": "82.5%", "topPosition": "12%", "annotationLinks": [{ "linkDesc": "You can enable or disable chart export using attribute `exportEnabled`. Learn more about its usage ", "linkPath": "/exporting-charts/using-fc-export-server/exporting-charts-as-image-and-pdf" }, { "linkDesc": "You can also define export mode like `server`, `client`, or `auto` for chart export. Learn more about them ", "linkPath": "/exporting-charts/using-fc-export-server/modes-of-export/exporting-charts-and-chart-data-using-the-server-side-export-feature" }, { "linkDesc": "Look and feel of this menu can also be customized using available attributes. Learn more about them ", "linkPath": "/exporting-charts/using-fc-export-server/configuring-the-export-feature" } ] } ] } ] } }

Pie 2D Chart

Let's create our first pie 2D chart which will showcase the split in revenue by product categories for one year.

To create a pie 2D chart follow the steps given below:

  • In the JSON data, set the attributes and their corresponding values in "<attributeName>": "<value>" format.

  • Specify the chart type using the type attribute. To render a pie 2D chart, set pie2d.

  • Set the container object using renderAt attribute.

  • Specify the dimension of the chart using width and height attributes.

  • Set the type of data (JSON/XML) you want to pass to the chart object using dataFormat attribute.

For a detailed list of attributes, refer to the chart attributes page of the pie 2D chart.

The pie 2D chart for the above code looks like:

FusionCharts will load here..
{
    "chart": {
        "caption": "Split of revenue by product categories",
        "subCaption": "Last year",
        "numberPrefix": "$",
        "showPercentInTooltip": "0",
        "decimals": "1",
        "useDataPlotColorForLabels": "1",
        "theme": "fusion"
    },
    "data": [
        {
            "label": "Food",
            "value": "285040"
        },
        {
            "label": "Apparels",
            "value": "146330"
        },
        {
            "label": "Electronics",
            "value": "105070"
        },
        {
            "label": "Household",
            "value": "49100"
        }
    ]
}
<chart caption="Split of revenue by product categories" subcaption="Last year" numberprefix="$" showpercentintooltip="0" decimals="1" usedataplotcolorforlabels="1" theme="fusion">
    <set label="Food" value="285040" />
    <set label="Apparels" value="146330" />
    <set label="Electronics" value="105070" />
    <set label="Household" value="49100" />
</chart>
<html>
<head>
	<title>My first chart using FusionCharts Suite XT</title>
	<script type="text/javascript" src="https://cdn.fusioncharts.com/fusioncharts/latest/fusioncharts.js"></script>
	<script type="text/javascript" src="https://cdn.fusioncharts.com/fusioncharts/latest/themes/fusioncharts.theme.fusion.js"></script>
	<script type="text/javascript">
		FusionCharts.ready(function(){
			var chartObj = new FusionCharts({
    type: 'pie2d',
    renderAt: 'chart-container',
    width: '550',
    height: '350',
    dataFormat: 'json',
    dataSource: {
        "chart": {
            "caption": "Split of revenue by product categories",
            "subCaption": "Last year",
            "numberPrefix": "$",
            "showPercentInTooltip": "0",
            "decimals": "1",
            "useDataPlotColorForLabels": "1",
            //Theme
            "theme": "fusion"
        },
        "data": [{
            "label": "Food",
            "value": "285040"
        }, {
            "label": "Apparels",
            "value": "146330"
        }, {
            "label": "Electronics",
            "value": "105070"
        }, {
            "label": "Household",
            "value": "49100"
        }]
    }
}
);
			chartObj.render();
		});
	</script>
	</head>
	<body>
		<div id="chart-container">FusionCharts XT will load here!</div>
	</body>
</html>

Click here to edit the pie 2D chart.

Pie 3D Chart

To render a pie chart in 3D, change the value of the type attribute from pie2D to pie3D. The rest of the data structure remains the same.

For a detailed list of attributes, refer to the chart attributes page of the pie 3D chart.

A pie chart in 3D looks like :

FusionCharts will load here..
{
    "chart": {
        "caption": "Split of revenue by product categories",
        "subCaption": "Last year",
        "numberPrefix": "$",
        "showPercentInTooltip": "0",
        "decimals": "1",
        "useDataPlotColorForLabels": "1",
        "theme": "fusion"
    },
    "data": [
        {
            "label": "Food",
            "value": "285040"
        },
        {
            "label": "Apparels",
            "value": "146330"
        },
        {
            "label": "Electronics",
            "value": "105070"
        },
        {
            "label": "Household",
            "value": "49100"
        }
    ]
}
<chart caption="Split of revenue by product categories" subcaption="Last year" numberprefix="$" showpercentintooltip="0" decimals="1" usedataplotcolorforlabels="1" theme="fusion">
    <set label="Food" value="285040" />
    <set label="Apparels" value="146330" />
    <set label="Electronics" value="105070" />
    <set label="Household" value="49100" />
</chart>
<html>
<head>
	<title>My first chart using FusionCharts Suite XT</title>
	<script type="text/javascript" src="https://cdn.fusioncharts.com/fusioncharts/latest/fusioncharts.js"></script>
	<script type="text/javascript" src="https://cdn.fusioncharts.com/fusioncharts/latest/themes/fusioncharts.theme.fusion.js"></script>
	<script type="text/javascript">
		FusionCharts.ready(function(){
			var chartObj = new FusionCharts({
    type: 'pie3d',
    renderAt: 'chart-container',
    width: '450',
    height: '300',
    dataFormat: 'json',
    dataSource: {
        "chart": {
            "caption": "Split of revenue by product categories",
            "subCaption": "Last year",
            "numberPrefix": "$",
            "showPercentInTooltip": "0",
            "decimals": "1",
            "useDataPlotColorForLabels": "1",
            //Theme
            "theme": "fusion"
        },
        "data": [{
            "label": "Food",
            "value": "285040"
        }, {
            "label": "Apparels",
            "value": "146330"
        }, {
            "label": "Electronics",
            "value": "105070"
        }, {
            "label": "Household",
            "value": "49100"
        }]
    }
}
);
			chartObj.render();
		});
	</script>
	</head>
	<body>
		<div id="chart-container">FusionCharts XT will load here!</div>
	</body>
</html>

Click here to edit the pie 3D chart.

Doughnut 2D Chart

As we know, a doughnut chart is similar to a pie chart. The only difference is that a doughnut chart has a blank center - as the name suggests, it looks like a doughnut.

{ "header": "Chart Anatomy", "subHeader": "To know how FusionCharts works it is important to understand the various components and concepts of a chart", "content": { "header": "Below are different sections with interactive annotated images describing various components and concepts of charts", "contentGroup": [{ "_itemHeader": "Doughnut Chart Anatomy", "imgSrc": "doughnut-chart-anatomy.png", "annotations": [{ "annotationNumber": "1", "annotationName": "Caption", "annotationDesc": "The caption (also called the chart title) is the heading of your chart, you can add custom text for the caption, as well as configure its font properties and cosmetics.", "annotationDescLinkPath": null, "leftPosition": "28.5%", "topPosition": "5.5%", "annotationLinks": [{ "linkDesc": "Learn how to add caption ", "linkPath": "/chart-guide/chart-configurations/caption-and-sub-caption#set-the-caption-and-subcaption" }, { "linkDesc": "Font properties and cosmetics of caption can also be customized using attributes, know more about them ", "linkPath": "/chart-guide/chart-configurations/caption-and-sub-caption#customize-font-properties" }, { "linkDesc": "You can also customize the alignment of the caption. Learn more about it ", "linkPath": "/chart-guide/chart-configurations/caption-and-sub-caption#configure-caption-alignment" } ] }, { "annotationNumber": "2", "annotationName": "Subcaption", "annotationDesc": "The sub-caption (also called the chart subtitle) is the sub-heading of your chart. You can add custom text for sub-caption, as well as configure its font properties.", "annotationDescLinkPath": null, "leftPosition": "52.5%", "topPosition": "10.5%", "annotationLinks": [{ "linkDesc": "Learn how to add sub-caption ", "linkPath": "/chart-guide/chart-configurations/caption-and-sub-caption#set-the-caption-and-subcaption" }, { "linkDesc": "Font properties and cosmetics of sub-caption can also be customized using attributes, learn more about them ", "linkPath": "/chart-guide/chart-configurations/caption-and-sub-caption#customize-font-properties" } ] }, { "annotationNumber": "3", "annotationName": "Data Plot", "annotationDesc": "Data plot refers to the pie/doughnut slices in a pie/doughnut chart, columns of the column chart, lines in a line chart.", "annotationDescLinkPath": null, "leftPosition": "38.5%", "topPosition": "38%", "annotationLinks": [{ "linkDesc": "You can customize the data plots, learn more about it ", "linkPath": "/chart-guide/chart-configurations/data-plot" } ] }, { "annotationNumber": "4", "annotationName": "Data Labels", "annotationDesc": "Data labels refer to the labels associated with each pie slice. Learn more about it ", "annotationDescLinkPath": "/chart-guide/chart-configurations/data-labels", "leftPosition": "21%", "topPosition": "42%", "annotationLinks": [] }, { "annotationNumber": "5", "annotationName": "Data Values", "annotationDesc": "Data values refer to values associated with each pie slice. Learn more about it ", "annotationDescLinkPath": "/chart-guide/chart-configurations/data-values", "leftPosition": "68%", "topPosition": "30%", "annotationLinks": [] }, { "annotationNumber": "6", "annotationName": "Legend", "annotationDesc": "A legend is a chart element used to display the series name for each dataset, in case of multi-series or combination charts. Legends are used to correlate a data plot to its series name using its color.", "annotationDescLinkPath": null, "leftPosition": "69%", "topPosition": "84%", "annotationLinks": [{ "linkDesc": "You can customize look and feel of legend like increase/decrease legend icon size, define custom legend icons, legend scroll, etc. Learn more about it ", "linkPath": "/chart-guide/chart-configurations/legend#configure-legend-icon-size" }, { "linkDesc": "You can customize legend position on the chart either to right or bottom of the chart. Learn more about it ", "linkPath": "/chart-guide/chart-configurations/legend#set-the-legend-position" }, { "linkDesc": "You can highlight data plots by hovering over corresponding legend item using plot highlight effect feature, Learn more about it ", "linkPath": "/chart-guide/chart-configurations/legend#highlight-a-data-series-via-the-legend" } ] }, { "annotationNumber": "8", "annotationName": "Export Menu", "annotationDesc": "Export menu is hamburger menu that appears on top-right of the chart by hovering on which you can export the chart using available options.", "annotationDescLinkPath": null, "leftPosition": "78.5%", "topPosition": "4%", "annotationLinks": [{ "linkDesc": "You can enable or disable chart export using attribute `exportEnabled`. Learn more about its usage ", "linkPath": "/exporting-charts/using-fc-export-server/exporting-charts-as-image-and-pdf" }, { "linkDesc": "You can also define export mode like `server`, `client`, or `auto` for chart export. Learn more about them ", "linkPath": "/exporting-charts/using-fc-export-server/modes-of-export/exporting-charts-and-chart-data-using-the-server-side-export-feature" }, { "linkDesc": "Look and feel of this menu can also be customized using available attributes. Learn more about them ", "linkPath": "/exporting-charts/using-fc-export-server/configuring-the-export-feature" } ] } ] } ] } }

Let's create our first doughnut 2D chart showcasing the same use case for the pie chart created above.

To create a doughnut 2D chart, set the type attribute to doughnut2d.

For a detailed list of attributes, refer to the chart attributes page of the doughnut 2D chart.

The doughnut 2D chart for the above code looks like:

FusionCharts will load here..
{
    "chart": {
        "caption": "Split of Revenue by Product Categories",
        "subCaption": "Last year",
        "numberPrefix": "$",
        "bgColor": "#ffffff",
        "startingAngle": "310",
        "showLegend": "1",
        "defaultCenterLabel": "Total revenue: $64.08K",
        "centerLabel": "Revenue from $label: $value",
        "centerLabelBold": "1",
        "showTooltip": "0",
        "decimals": "0",
        "theme": "fusion"
    },
    "data": [
        {
            "label": "Food",
            "value": "28504"
        },
        {
            "label": "Apparels",
            "value": "14633"
        },
        {
            "label": "Electronics",
            "value": "10507"
        },
        {
            "label": "Household",
            "value": "4910"
        }
    ]
}
<chart caption="Split of Revenue by Product Categories" subcaption="Last year" numberprefix="$" bgcolor="#ffffff" startingangle="310" showlegend="1" defaultcenterlabel="Total revenue: $64.08K" centerlabel="Revenue from $label: $value" centerlabelbold="1" showtooltip="0" decimals="0" theme="fusion">
    <set label="Food" value="28504" />
    <set label="Apparels" value="14633" />
    <set label="Electronics" value="10507" />
    <set label="Household" value="4910" />
</chart>
<html>
<head>
	<title>My first chart using FusionCharts Suite XT</title>
	<script type="text/javascript" src="https://cdn.fusioncharts.com/fusioncharts/latest/fusioncharts.js"></script>
	<script type="text/javascript" src="https://cdn.fusioncharts.com/fusioncharts/latest/themes/fusioncharts.theme.fusion.js"></script>
	<script type="text/javascript">
		FusionCharts.ready(function(){
			var chartObj = new FusionCharts({
    type: 'doughnut2d',
    renderAt: 'chart-container',
    width: '550',
    height: '450',
    dataFormat: 'json',
    dataSource: {
        "chart": {
            "caption": "Split of Revenue by Product Categories",
            "subCaption": "Last year",
            "numberPrefix": "$",
            "bgColor": "#ffffff",
            "startingAngle": "310",
            "showLegend": "1",
            "defaultCenterLabel": "Total revenue: $64.08K",
            "centerLabel": "Revenue from $label: $value",
            "centerLabelBold": "1",
            "showTooltip": "0",
            "decimals": "0",
            "theme": "fusion"
        },
        "data": [{
            "label": "Food",
            "value": "28504"
        }, {
            "label": "Apparels",
            "value": "14633"
        }, {
            "label": "Electronics",
            "value": "10507"
        }, {
            "label": "Household",
            "value": "4910"
        }]
    }
}
);
			chartObj.render();
		});
	</script>
	</head>
	<body>
		<div id="chart-container">FusionCharts XT will load here!</div>
	</body>
</html>

Click here to edit the doughnut 2D chart.

Doughnut 3D Chart

To render a doughnut chart in 3D, change the value of the type attribute from doughnut2D to doughnut3D. The rest of the data structure remains the same.

For a detailed list of attributes, refer to the chart attributes page of the doughnut 3D chart.

A doughnut chart in 3D looks like :

FusionCharts will load here..
{
    "chart": {
        "caption": "Split of Revenue by Product Categories",
        "subCaption": "Last year",
        "numberPrefix": "$",
        "bgColor": "#ffffff",
        "startingAngle": "310",
        "showLegend": "1",
        "defaultCenterLabel": "Total revenue: $64.08K",
        "centerLabel": "Revenue from $label: $value",
        "centerLabelBold": "1",
        "showTooltip": "0",
        "decimals": "0",
        "theme": "fusion"
    },
    "data": [
        {
            "label": "Food",
            "value": "28504"
        },
        {
            "label": "Apparels",
            "value": "14633"
        },
        {
            "label": "Electronics",
            "value": "10507"
        },
        {
            "label": "Household",
            "value": "4910"
        }
    ]
}
<chart caption="Split of Revenue by Product Categories" subcaption="Last year" numberprefix="$" bgcolor="#ffffff" startingangle="310" showlegend="1" defaultcenterlabel="Total revenue: $64.08K" centerlabel="Revenue from $label: $value" centerlabelbold="1" showtooltip="0" decimals="0" theme="fusion">
    <set label="Food" value="28504" />
    <set label="Apparels" value="14633" />
    <set label="Electronics" value="10507" />
    <set label="Household" value="4910" />
</chart>
<html>
<head>
	<title>My first chart using FusionCharts Suite XT</title>
	<script type="text/javascript" src="https://cdn.fusioncharts.com/fusioncharts/latest/fusioncharts.js"></script>
	<script type="text/javascript" src="https://cdn.fusioncharts.com/fusioncharts/latest/themes/fusioncharts.theme.fusion.js"></script>
	<script type="text/javascript">
		FusionCharts.ready(function(){
			var chartObj = new FusionCharts({
    type: 'doughnut3d',
    renderAt: 'chart-container',
    width: '550',
    height: '450',
    dataFormat: 'json',
    dataSource: {
        "chart": {
            "caption": "Split of Revenue by Product Categories",
            "subCaption": "Last year",
            "numberPrefix": "$",
            "bgColor": "#ffffff",
            "startingAngle": "310",
            "showLegend": "1",
            "defaultCenterLabel": "Total revenue: $64.08K",
            "centerLabel": "Revenue from $label: $value",
            "centerLabelBold": "1",
            "showTooltip": "0",
            "decimals": "0",
            "theme": "fusion"
        },
        "data": [{
            "label": "Food",
            "value": "28504"
        }, {
            "label": "Apparels",
            "value": "14633"
        }, {
            "label": "Electronics",
            "value": "10507"
        }, {
            "label": "Household",
            "value": "4910"
        }]
    }
}
);
			chartObj.render();
		});
	</script>
	</head>
	<body>
		<div id="chart-container">FusionCharts XT will load here!</div>
	</body>
</html>

Click here to edit the doughnut 3D chart.

Now, let's customize the appearance and properties of pie and doughnut charts.

Configure the Animation Direction

By default, when a pie/doughnut chart is loaded for the first time or refreshed, the rendering animation is in the anti-clockwise direction. However, FusionCharts includes the animateClockwise attribute that lets you animate the chart in the clockwise direction. Set the animateClockwise attribute to 1 to animate the chart in the clockwise direction.

Refer to the code given below:

{
  "chart": {
    "animateClockwise": "1"
  }
}

A pie chart configured to animate in the clockwise direction is shown below.

Pie chart

Click here to edit the above chart.

Show Percent Values and Actual Values

By default, for a pie chart, the actual data values are shown on the chart and in the tooltips. However, you can choose to show percent values on the chart while retaining the actual values in tooltips.

To show percent values and actual values in your chart, follow the steps given below:

  • Set the showPercentValues attribute to 1 to show percent values as data labels.

  • Set the showPercentInTooltip attribute to 1 to render the tooltip text in percentage values.

The showPercentValues and the showPercentInTooltip attributes are applicable if you want to show percent values on the chart and actual values in tool-tips for a doughnut chart.

Refer to the code given below:

{
  "chart": {
    "showPercentValues": "1",
    "showPercentInTooltip": "0"
  }
}

A pie2D chart configured to show percent values on the chart looks like this:

Click here to edit the pie 2D chart.

Place values inside the Pie/Doughnut chart

Starting v3.14.0, FusionCharts Suite XT allows you to place the values inside the pie/doughnut slices of a pie and doughnut chart respectively. This helps to improve the overall look as it saves the canvas area outside the chart.

You can place the value inside the slices by setting the value of the newly added attribute valuePosition to inside. The default value of valuePosition attribute is outside.

valuePosition attribute can only be applied to 2D charts, i.e., pie2d and doughnut2d charts.

Refer to the code below:

{
  "chart": {
    "valuePosition": "inside"
  }
}

valuePosition attribute can be applied both at chart and data level, i.e., you can set the position of the individual values of the slices.

Refer to the code below, showing the valuePosition attribute for a particular value:

{
    "chart": {
        ...
    },
    "data": [{
            "label": "Food",
            "value": "285040"
        },
        {
            "label": "Apparels",
            "value": "146330",
            "valuePosition": "inside"
        },
        {
            "label": "Electronics",
            "value": "105070"
        },
        {
            "label": "Household",
            "value": "49100"
        }
    ]
}

A pie2d with valuePosition attribute set to inside (at chart level) is shown below:

FusionCharts will load here..

Click here to edit the above chart.

In a pie/doughnut charts, changing the position of the value can sometimes overlap each other due to the unavailability of space. For this scenario, a new attribute minAngleForValue has been introduced which sets the minimum angle of the pie below which the values will not be visible.

Refer to the code below:

{
  "chart": {
    "valuePosition": "inside",
    "minAngleForValue": "75"
  }
}

This attribute will only work if the valuePosition attribute is set to inside.

A doughnut chart after applying valuePosition and minAngleForValue attribute look like:

FusionCharts will load here..

Click here to edit the above chart.

Place label inside the Pie/Doughnut Chart

Now that you have already customized the position of the values of a pie/doughnut charts, let's see how to place the labels inside the pie/doughnut slices of a pie and doughnut chart respectively.

You can place the label inside the slices by setting the value of the labelPosition attribute to inside****. The default value of labelPosition attribute is outside.

labelPosition attribute can only be applied to 2D charts, i.e., pie2d and doughnut2d charts.

Refer to the code below:

{
  "chart": {
    "labelPosition": "inside"
  }
}

labelPosition attribute can be applied both at chart and data level, i.e., you can set the position of the individual labels of the slices.

Refer to the code below, showing the labelPosition attribute for a particular value:

{
    "chart": {
        ...
    },
    "data": [{
            "label": "Food",
            "value": "285040"
        },
        {
            "label": "Apparels",
            "value": "146330",
            "labelPosition": "inside"
        },
        {
            "label": "Electronics",
            "value": "105070"
        },
        {
            "label": "Household",
            "value": "49100"
        }
    ]
}

A pie2d with labelPosition attribute set to inside (at chart level) is shown below:

FusionCharts will load here..

Click here to edit the above chart.

In a pie/doughnut charts, changing the position of the label can sometimes overlap each other due to the unavailability of space. For this scenario, a new attribute minAngleForLabel has been introduced which sets the minimum scale angle to render the label of the pie/doughnut charts.

Refer to the code below:

{
  "chart": {
    "labelPosition": "inside",
    "minAngleForLabel": "75"
  }
}

This attribute will only work if the valuePosition attribute is set to inside.

A doughnut chart after applying labelPosition and minAngleForLabel attribute look like:

FusionCharts will load here..

Click here to edit the above chart.

Customize the Center Label for a Doughnut Chart

For a doughnut chart, you can configure the default text that will be rendered on the center label. You can also configure the text that will be rendered on the center label when the mouse pointer is hovered over one of the doughnut slices.

To customize the center label of your chart, follow the steps given below:

  • Specify the text of the center label using the defaultCenterLabel attribute.

  • Specify the hover text of a doughnut slice using the centerLabel attribute.

Refer to the code given below:

{
  "chart": {
    "defaultCenterLabel": "Total revenue: $60K",
    "centerLabel": "$value"
  }
}

A doughnut chart with the center label customized looks like this:

FusionCharts will load here..

Click here to edit the doughnut 2D chart.

Enable Single-Slice Slicing

By default, the pie and doughnut charts allow you to slice out multiple pie/doughnut slices at one time. You can, however, opt to enable slicing-out only one slice at a time.

By default, multiple slicing is enabled. To stop the multiple slicing set the enableMultiSlicing attribute to 0.

Refer to the code given below:

{
  "chart": {
    "enableMultiSlicing": "0"
  }
}

A doughnut chart with single-slicing enabled looks like this:

FusionCharts will load here..

Click here to edit the doughnut 2D chart.

Disable Smart Labels and Lines

By default, pie and doughnut charts are rendered with smart labels and lines - smart labels are data labels connected to their corresponding pie slices using line segments called smart lines. Smart labels manage overlapping of labels even when a large number of labels are placed in the close vicinity. You can, however, choose to disable these smart labels.

To disable the smart labels, set enableSmartLabels attribute to 0.

Refer to the code given below:

{
  "chart": {
    "enableSmartLabels": "0"
  }
}

A pie chart with smart labels disabled looks like this:

FusionCharts will load here..

Click here to edit the pie 2D chart.

If smart labels are disabled then, in case of a large number of labels, the labels might overlap each other.

Customize Smart Lines

Apart from enabling and disabling the smart lines, you can also set the cosmetic properties of smart lines. To customize the smart lines, follow the steps given below:

  • Specify the hex code for the smart line color using the smartLineColor attribute.

  • Set the thickness of the smart lines using the smartLineThickness attribute.

  • Set the transparency of the smart lines using the smartLineAlpha attribute. This attribute takes values between 0 (transparent) and 100 (opaque).

  • Set the isSmartLineSlanted attribute to 0 to render the smart lines as straight lines.

Refer to the code given below:

{
  "chart": {
    "smartLineColor": "#ff0000",
    "smartLineThickness": "2",
    "smartLineAlpha": "100",
    "isSmartLineSlanted": "0"
  }
}

A pie chart with the cosmetic properties of smart lines customized looks like this:

FusionCharts will load here..

Click here to edit the pie 2D chart.

Configuring the Label Distance and Clearance

Now, you already know how to customize the labels and the label lines in a chart. Here let's discuss how to configure the label distance of a chart.

To configure the label distance and clearance, follow the steps given below:

  • Set the distance (in pixels) between the label/value from the pie/doughnut edge using the labelDistance attribute.

This attribute is applicable only when smart labeling is disabled.

Refer to the code given below:

{
  "chart": {
    "enableSmartLabels": "0",
    "labelDistance": "5"
  }
}
FusionCharts will load here..

Click here to edit the pie 2D chart.

Skip Overlap Labels

When there are too many labels in the pie/doughnut chart (which is difficult to adjust even if you are using smart labels), the labels may overlap. In this case, you have the option to skip the overlapping labels. The labels of the least significant pies will be removed. To skip the overlapping of labels set the skipOverlapLabels attribute to 1.

Refer to the code given below:

{
  "chart": {
    "skipOverlapLabels": "1"
  }
}

Customize Pie Radius

By default, for pie/doughnut charts, the chart automatically calculates the best fit pie radius based on the data provided. However, you can choose to explicitly set the outer radius of the pie chart. Specify the outer radius of the pie/doughnut chart using pieRadius attribute.

Starting v3.14.0, you can specify the radius of a pie/doughnut chart in both percentage and pixel values.

Refer to the code given below:

{
  "chart": {
    "pieRadius": "50"
  }
}

A pie chart with the outer radius customized looks like this:

FusionCharts will load here..

Click here to edit the pie 2D chart.

Set the radius as a percent value

Now, you already know how to customize the radius of the pie/doughnut chart. Here let's discuss how to configure the radius of the pie/doughnut chart using percent values.

You can set the radius of the pie chart in percent by setting the value of pieRadius attribute. When you set the value of pieRadius in percent, the radius of the pie is calculated with respect to the chart canvas space.

Refer to the image shown below:

Percent Value on Pie Chart

Click here to edit the above chart.

In the doughnut chart, you can apply the pieRadius attribute to set the radius of the upper threshold of the doughnut chart.

Refer to the image below:

Percent Value on Doughnut Chart

Click here to edit the above chart.

To customize the inner radius of the doughnut chart, set the value of doughnutRadius attribute in percent.

Refer to the image below:

Doughnut Radius on Doughnut Chart

In the above image, the doughnutRadius has been set to 80% and as you can see that the percent of the radius has been calculated with respect to the upper threshold of the doughnut chart.

Starting v3.14.0, you can specify the radius of a pie/doughnut chart in both percentage and pixel values.

Refer to the code given below:

{
  "chart": {
    "pieRadius": "90",
    "doughnutRadius": "80"
  }
}

Click here to edit the above chart.

Set the Starting Angle

By default, pie/doughnut charts start plotting from the 0° angle. The chart allows you to explicitly set the starting angle. Specify the startingAngle attribute set the starting angle for the pie/doughnut chart. The first pie slice will start plotting from the angle measure specified in this attribute.

Refer to the code given below:

{
  "chart": {
    "startingAngle": "45"
  }
}

A pie chart with the starting angle set to 45° looks like this:

FusionCharts will load here..

Click here to edit the pie 2D chart.

Slice a Pie/Doughnut

When a pie/doughnut chart first renders, by default, all slices are sliced-in. However, to highlight a slice, you may want to render it sliced-out when the chart first loads. isSliced attribute can be used to specify the pie chart will be rendered with one slice sliced-out. Set this attribute to 1 for a pie slice to render a slice sliced-out. This attribute belongs to the data object.

Refer to the code given below:

{
  "data": {
    "label": "Household",
    "value": "49100",
    "isSliced": "1"
}

A pie chart rendered with one slice sliced-out looks like this:

FusionCharts will load here..

Click here to edit the pie 2D chart.

Configure the Slicing Distance

When a pie/doughnut slice is sliced-out, you can configure the distance between the center and the sliced-out slices. Set the distance (in pixels) between the center of the chart and the sliced out slices using slicingDistance attribute.

Refer to the code given below:

{
  "chart": {
    "slicingDistance": "10"
  }
}

A chart with the slicing distance configured looks like this:

FusionCharts will load here..

Click here to edit the pie 2D chart.

Configure the Bevel Effect

For pie/doughnut charts, you can configure the bevel effect to render the chart with 3D effects. Set the use3DLighting attribute to 1 to specify whether advanced gradients and shadow effects will be used to create better looking charts.

Set the 3D radius of the chart using radius3D attribute. Using this attribute the radius is set in percentage when the chart is rendered in the 3D lighting mode. It basically helps to set the bevel distance for the pie/doughnut.

Refer to the code given below:

{
  "chart": {
    "use3DLighting": "1",
    "radius3D": "50"
  }
}

A pie chart configured for the bevel effect looks like this:

FusionCharts will load here..

Click here to edit the pie 2D chart.

For all the samples shown above, if you want to see how each attribute works for the doughnut chart, just change the value of the type attribute from pie2D/pie3D to doughnut2D/doughnut3D