chart
A chart
shape is used to render data in a graphical form. All chart types provided by PowerPoint are supported.
settings
Object
[optional] Customise specific chart properties. See settings object for more information.
is_hidden
Boolean
true; false
[optional] Hide shape
remove
Boolean
true; false
[optional] Delete shape
JSON payload
Data Object
The data
object is used to populate a chart shape. The data is organized as an array of arrays, where each inner array represents a different dimension of the data.
In the example payload below, the matrix would be of size 4x2, where there are 4 columns (series) and 2 rows (categories). The first column of the matrix would contain the values for the "series 1", the second column would contain the values for the "series 2", and so on. Similarly, the first row of the matrix would contain the values for the "category 1", the second row would contain the values for the "category 2".
JSON payload
Settings Object
The settings
parameters below are specific to chart shapes only. Chart shape consists of several different elements, like plot area, legend and so on, we have grouped the settings to match these elements below.
Chart Area
title
String
[optional] Shorthand way of adding text to a chart's title
chartFont
String
MS supported font names
[optional] The text font applies to all text in the chart shape
chartFontSize
Integer
1 to 4000
[optional] The text font size applies to all text in the chart shape
JSON payload
Legend
chartShowLegend
Boolean
true, false
[optional] Enable/disable legend
chartLegendPosition
String
Left,
Right,
Bottom,
Top,
Topright,
None
[optional] Set Chart series label / legend display position, if visible
chartLegendFontColor
String
Color name, RGB(0,0,0),
[optional] Set chart legend color – applies all legend items i.e. not individual series, if visible
isChartLegendBold
Boolean
true, false
[optional] Enable/disable chart legend text bold, if visible
JSON payload
Data labels
isChartLabelValueVisible
Boolean
true, false
[optional] Enable/ disable data label
chartDataLabelPosition
String
Left,
Right,
Top,
Bottom,
Center,
InsideBase,
InsideEnd,
OutsideEnd,
BestFit
[optional] Set data label position, if enabled
chartDataLabelFontSize
Integer
1 to 4000
[optional] Set data label's font size, if data label visible
chartDataLabelFont
String
MS supported font names
[optional] Set data label's font, if data label visible
isDataLabelBold
Boolean
true, false
[optional] Enable/ disable chart data value label bold, if data label visible
chartDataLabelColor
String
Color name, RGB(0,0,0),
[optional] Chart data value label color, if data label visible
JSON payload
Category axis
categoryTitle
String
[optional] Shorthand way of adding text to a chart's category axis title
chartCategoryAxisFontSize
Integer
1 to 4000
[optional] Set axis font size
isCategoryAxisBold
Boolean
true, false
[optional] Enable/ disable bold
chartCategoryAxisPosition
String
nextToAxis,
high,
low,
none
[optional] Set axis position
chartCategoryAxisMax
String
[optional] Set axis maximum value
chartCategoryAxisMin
String
[optional] Set axis maximum value
JSON payload
Value axis
valueTitle
String
[optional] Shorthand way of adding text to a chart's value axis title
chartValueAxisFontSize
Integer
1 to 4000
[optional] Set axis font size
isValueAxisBold
Boolean
true, false
[optional] Enable/ Disable bold
chartValueAxisPosition
String
nextToAxis,
high,
low,
none
[optional] Set axis position
chartValueAxisMax
String
[optional] Set axis maximum value
chartValueAxisMin
String
[optional] Set axis minimum value
JSON payload
Plot area
isLabelValueVisible
Boolean
true, false
[optional] Enable/ disable data labels
showChartVerticalGridLines
Boolean
true, false
[optional] Enable/ disable vertical grid lines
showChartHorizantalGridLines
Boolean
true, false
[optional] Enable/ disable horizontal grid lines
chartOverlap
Integer
-100 to 100
[optional] Set series overlap
chartGapWidth
Integer
0 to 500
[optional] Set series gap width
JSON payload
Size & Position
width
Integer,
Float
0 to 5963.92
[optional] Set shape width
height
Integer,
Float
0 to 5963.92
[optional] Set shape height
left
Integer,
Float
-5963.92 to 5963.92
[optional] Set left position
top
Integer,
Float
-5963.92 to 5963.92
[optional] Set top position
unit
String
cm
,
pt
,
points
(default value if ‘unit’ field is not specified)
[optional] Set unit of measurement for shape width
, height
, left
, top
JSON payload
Last updated