Pie & Donut fields and settings
Every field well and every setting in the format pane of version 1.0.0.0, read from the package you download. The internal names in grey are what a PBIR file or a report-authoring agent uses. Which features need a licence is on the Pie & Donut page; every setting works in edit mode with or without one.
14 fields · 23 cards · 109 settings Markdown for AI assistantscatalog.json
Fields
| Field | Takes | Needed | What it is for |
|---|---|---|---|
Categorycategory | Column | Optional | The parts: slices, petals, rings, cells, icons, stages or columns |
Segmentsegment | Column | Optional | A second split: an outer ring, stacked petals or stages, Marimekko rows, waffle colours |
Valuesvalues | Measure | Optional | The size of each part |
Comparecompare | Measure | Optional | Last period, plan or any reference: share shift, ghost marks, findings (premium) |
Targettarget | Measure | Optional | A goal per part |
Unitsunits | Measure | Optional | Quantities behind Values: splits the change into volume, mix and price (premium) |
Compare unitscompareUnits | Measure | Optional | Quantities behind Compare (premium) |
Iconicon | Measure | Optional | Built-in icon name, SVG path or data:image URI per part |
Annotationannotation | Measure | Optional | Text measure: a callout on the part |
Play axisplay | Column | Optional | Periods to play through (premium) |
Small multiplesfacet | Column | Optional | One chart per value |
Tooltipstooltips | Measure | Optional | Extra fields in tooltips |
Centre valuecentreValue | Measure | Optional | Shown in the centre instead of the total (a ratio: make every part return the same value, e.g. with ALLSELECTED) |
Show conditionshowCondition | Measure | Optional | A measure returning 1 / TRUE to show the chart, 0 / FALSE / blank to show a message instead |
Templatestemplates
| Setting | Type and options |
|---|---|
Style Templatepreset |
|
Appliedapplied | Text |
Pie & Donutpie
| Setting | Type and options |
|---|---|
Shapeshape |
|
Hole Size (%)innerRadius | Number |
Arcarc |
|
Start Angle (°)startAngle | Number |
Sweep (°)sweep | Number |
Gaps Between Slicesgap |
|
Cornerscorners |
|
Pull Out the Selected Sliceexplode | On / off |
Segment Field Asnested |
|
Segment Names on the RingsegmentLabels | On / off |
Bar of Pie (Expand Other)barOfPie | On / off |
Spotlightspotlight |
|
Spotlight SlicespotlightName | Text |
Images in Slicesimages | On / off |
Depth Style (no tilt)depth | On / off |
Sorting and Othersorting
| Setting | Type and options |
|---|---|
Sortsort |
|
Readers Can Change the SortreaderSort | On / off |
Group Small Items Into Otherother | On / off |
Show at Most (items)maxItems | Number |
Group Items Below (%)minShare | Number |
Other LabelotherLabel | Text |
Data Labelslabels
| Setting | Type and options |
|---|---|
Showshow | On / off |
Contentcontent |
|
Positionposition |
|
Percent DecimalspercentDecimals | Number |
Display UnitsdisplayUnits |
|
Value Decimals (-1 = auto)valueDecimals | Number |
Hide Labels Below (%)hideBelow | Number |
Font SizefontSize | Number |
Text Colourcolor | Colour |
Detail Text SizedetailSize | Number |
Detail Text ColourdetailColor | Colour |
Centrecentre
| Setting | Type and options |
|---|---|
Showshow | On / off |
Contentcontent |
|
Caption Under the Valuelabel | Text |
Value Font Size (0 = auto)fontSize | Number |
Text Colourcolor | Colour |
Legendlegend
| Setting | Type and options |
|---|---|
Showshow | On / off |
Positionposition |
|
Font SizefontSize | Number |
Text Colourcolor | Colour |
Colour RulescolorRules
| Setting | Type and options |
|---|---|
Rulemode |
|
Top NtopN | Number |
Thresholdthreshold | Number |
Highlight / Above ColourhighColor | Colour |
Others / Below ColourlowColor | Colour |
Comparecompare
| Setting | Type and options |
|---|---|
Show the Comparisonshow | On / off |
Comparison Namename | Text |
Change Labelslabels |
|
Draw the Comparison (ghost)ghost | On / off |
Sort by ChangesortByChange | On / off |
Volume vs Mix SplitvolumeMix | On / off |
Concentration (HHI, top 3)concentration | On / off |
Share Bridge (points won and lost)shareBridge | On / off |
Movers in the BridgebridgeItems | Number |
Segment CAGR Above Columnscagr | On / off |
Years Between the Periodsyears | Number |
Targetstargets
| Setting | Type and options |
|---|---|
Show Targetsshow | On / off |
One Target for All (0 = off)global | Number |
Met at (% of target)metAt | Number |
Close at (% of target)closeAt | Number |
Met ColourmetColor | Colour |
Close ColourcloseColor | Colour |
Missed ColourmissedColor | Colour |
Colour Items by StatusstatusColors | On / off |
Significancesignificance
| Setting | Type and options |
|---|---|
Test the Changeshow | On / off |
Significance Levelalpha |
|
Values ArevaluesAre |
|
Test Againstreference |
|
Play Over Periodsplay
| Setting | Type and options |
|---|---|
Seconds per Periodspeed | Number |
Looploop | On / off |
Findingsfindings
| Setting | Type and options |
|---|---|
What Changed (findings)show | On / off |
Number of Findingsmax | Number |
Font SizefontSize | Number |
Text Colourcolor | Colour |
Smart Captioncaption
| Setting | Type and options |
|---|---|
Showshow | On / off |
Positionposition |
|
Font SizefontSize | Number |
Text Colourcolor | Colour |
Small MultiplessmallMultiples
| Setting | Type and options |
|---|---|
Columns (0 = auto)columns | Number |
Shared ScalesharedScale | On / off |
Size Pies by Their TotalsizeByTotal | On / off |
Title Font SizetitleSize | Number |
Title ColourtitleColor | Colour |
Annotationsannotations
| Setting | Type and options |
|---|---|
Showshow | On / off |
Font SizefontSize | Number |
Colourcolor | Colour |
Show ConditionshowCondition
| Setting | Type and options |
|---|---|
Message When Hiddenmessage | Text |
Data TabledataTable
| Setting | Type and options |
|---|---|
Table Button in the Visualbutton | On / off |
Open as Tablestart | On / off |
Zoomzoom
| Setting | Type and options |
|---|---|
Ctrl + Wheel Zooms, Drag Pansenabled | On / off |
Footnotefootnote
| Setting | Type and options |
|---|---|
Showshow | On / off |
Sourcesource | Text |
State the MethodsshowMethod | On / off |
Font SizefontSize | Number |
Text Colourcolor | Colour |
Tabs and Buttonscontrols
| Setting | Type and options |
|---|---|
Font SizefontSize | Number |
Text Colourcolor | Colour |
Accessibilityaccessibility
| Setting | Type and options |
|---|---|
Patterns (Tell Items Apart Without Colour)patterns | On / off |
Focus Outline ColourfocusColor | Colour |
Focus Outline WidthfocusWidth | Number |
Minimum Text Size (0 = off)minFontSize | Number |
Reduce MotionreduceMotion | On / off |
Themetheme
| Setting | Type and options |
|---|---|
ThemeselectedTheme |
|
Fontfont |
|
Transparent BackgroundtransparentBg | On / off |
Data ColoursdataPoint
| Setting | Type and options |
|---|---|
Colourfill | Colour |
Setting a value in PBIR
In a visual.json, a setting goes under visual.objects, by card and internal name. Toggles take true or false, choices and text a value in single quotes ('auto'), numbers a D suffix (12D).
"visual": {
"visualType": "smartvisualsPieDonutDA5731150FF19D2748671B258AC9657A",
"objects": {
"pie": [{
"properties": {
"explode": { "expr": { "Literal": { "Value": "true" } } }
}
}]
}
}