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

    FieldTakesNeededWhat it is for
    CategorycategoryColumnOptionalThe parts: slices, petals, rings, cells, icons, stages or columns
    SegmentsegmentColumnOptionalA second split: an outer ring, stacked petals or stages, Marimekko rows, waffle colours
    ValuesvaluesMeasureOptionalThe size of each part
    ComparecompareMeasureOptionalLast period, plan or any reference: share shift, ghost marks, findings (premium)
    TargettargetMeasureOptionalA goal per part
    UnitsunitsMeasureOptionalQuantities behind Values: splits the change into volume, mix and price (premium)
    Compare unitscompareUnitsMeasureOptionalQuantities behind Compare (premium)
    IconiconMeasureOptionalBuilt-in icon name, SVG path or data:image URI per part
    AnnotationannotationMeasureOptionalText measure: a callout on the part
    Play axisplayColumnOptionalPeriods to play through (premium)
    Small multiplesfacetColumnOptionalOne chart per value
    TooltipstooltipsMeasureOptionalExtra fields in tooltips
    Centre valuecentreValueMeasureOptionalShown in the centre instead of the total (a ratio: make every part return the same value, e.g. with ALLSELECTED)
    Show conditionshowConditionMeasureOptionalA measure returning 1 / TRUE to show the chart, 0 / FALSE / blank to show a message instead

    Templatestemplates

    SettingType and options
    Style Templatepreset
    • None (style defaults) none
    • Executive executive
    • IBCS (Finance) ibcs
    • Minimal minimal
    • Presentation presentation
    • Print print
    • Infographic infographic
    • Custom custom
    AppliedappliedText

    Pie & Donutpie

    SettingType and options
    Shapeshape
    • Donut donut
    • Pie pie
    Hole Size (%)innerRadiusNumber
    Arcarc
    • Full circle full
    • Semicircle semi
    • Three quarters (270°) threeQuarter
    • Custom start and sweep custom
    Start Angle (°)startAngleNumber
    Sweep (°)sweepNumber
    Gaps Between Slicesgap
    • From theme theme
    • None none
    • Small small
    • Large large
    Cornerscorners
    • From theme theme
    • Square square
    • Rounded rounded
    Pull Out the Selected SliceexplodeOn / off
    Segment Field Asnested
    • Outer ring (nested donut) ring
    • Shades inside each slice shades
    • Ignore ignore
    Segment Names on the RingsegmentLabelsOn / off
    Bar of Pie (Expand Other)barOfPieOn / off
    Spotlightspotlight
    • None none
    • The largest slice largest
    • A slice by name named
    Spotlight SlicespotlightNameText
    Images in SlicesimagesOn / off
    Depth Style (no tilt)depthOn / off

    Sorting and Othersorting

    SettingType and options
    Sortsort
    • Largest first desc
    • Smallest first asc
    • Name name
    • Data order data
    • Stage order field order
    Readers Can Change the SortreaderSortOn / off
    Group Small Items Into OtherotherOn / off
    Show at Most (items)maxItemsNumber
    Group Items Below (%)minShareNumber
    Other LabelotherLabelText

    Data Labelslabels

    SettingType and options
    ShowshowOn / off
    Contentcontent
    • Category category
    • Value value
    • Percent of total percent
    • Category, percent categoryPercent
    • Category, value categoryValue
    • Value, percent valuePercent
    • Category, value, percent all
    Positionposition
    • Auto auto
    • Inside inside
    • Outside with leader lines outside
    Percent DecimalspercentDecimalsNumber
    Display UnitsdisplayUnits
    • Auto auto
    • None none
    • Thousands K
    • Millions M
    • Billions B
    Value Decimals (-1 = auto)valueDecimalsNumber
    Hide Labels Below (%)hideBelowNumber
    Font SizefontSizeNumber
    Text ColourcolorColour
    Detail Text SizedetailSizeNumber
    Detail Text ColourdetailColorColour

    Centrecentre

    SettingType and options
    ShowshowOn / off
    Contentcontent
    • Total total
    • Hovered item, else total hover
    • Largest item's share largest
    Caption Under the ValuelabelText
    Value Font Size (0 = auto)fontSizeNumber
    Text ColourcolorColour

    Legendlegend

    SettingType and options
    ShowshowOn / off
    Positionposition
    • Auto (only when labels do not name the items) auto
    • Top top
    • Bottom bottom
    • Right right
    • Left left
    Font SizefontSizeNumber
    Text ColourcolorColour

    Colour RulescolorRules

    SettingType and options
    Rulemode
    • None (one colour per item) none
    • Highlight the top N rank
    • Above / below a value value
    • Above / below a share (%) share
    Top NtopNNumber
    ThresholdthresholdNumber
    Highlight / Above ColourhighColorColour
    Others / Below ColourlowColorColour

    Comparecompare

    SettingType and options
    Show the ComparisonshowOn / off
    Comparison NamenameText
    Change Labelslabels
    • Share shift (pp) pp
    • Value change value
    • % change percent
    • None none
    Draw the Comparison (ghost)ghostOn / off
    Sort by ChangesortByChangeOn / off
    Volume vs Mix SplitvolumeMixOn / off
    Concentration (HHI, top 3)concentrationOn / off
    Share Bridge (points won and lost)shareBridgeOn / off
    Movers in the BridgebridgeItemsNumber
    Segment CAGR Above ColumnscagrOn / off
    Years Between the PeriodsyearsNumber

    Targetstargets

    SettingType and options
    Show TargetsshowOn / off
    One Target for All (0 = off)globalNumber
    Met at (% of target)metAtNumber
    Close at (% of target)closeAtNumber
    Met ColourmetColorColour
    Close ColourcloseColorColour
    Missed ColourmissedColorColour
    Colour Items by StatusstatusColorsOn / off

    Significancesignificance

    SettingType and options
    Test the ChangeshowOn / off
    Significance Levelalpha
    • 95 % (α = 0.05) 0.05
    • 99 % (α = 0.01) 0.01
    • 90 % (α = 0.10) 0.1
    Values ArevaluesAre
    • Automatic (whole numbers, not currency or %) auto
    • Counts (opportunities, people, orders) counts
    • Amounts (revenue, value): not tested amounts
    Test Againstreference
    • The Compare field compare
    • The first segment firstSegment

    Play Over Periodsplay

    SettingType and options
    Seconds per PeriodspeedNumber
    LooploopOn / off

    Findingsfindings

    SettingType and options
    What Changed (findings)showOn / off
    Number of FindingsmaxNumber
    Font SizefontSizeNumber
    Text ColourcolorColour

    Smart Captioncaption

    SettingType and options
    ShowshowOn / off
    Positionposition
    • Top top
    • Bottom bottom
    Font SizefontSizeNumber
    Text ColourcolorColour

    Small MultiplessmallMultiples

    SettingType and options
    Columns (0 = auto)columnsNumber
    Shared ScalesharedScaleOn / off
    Size Pies by Their TotalsizeByTotalOn / off
    Title Font SizetitleSizeNumber
    Title ColourtitleColorColour

    Annotationsannotations

    SettingType and options
    ShowshowOn / off
    Font SizefontSizeNumber
    ColourcolorColour

    Show ConditionshowCondition

    SettingType and options
    Message When HiddenmessageText

    Data TabledataTable

    SettingType and options
    Table Button in the VisualbuttonOn / off
    Open as TablestartOn / off

    Zoomzoom

    SettingType and options
    Ctrl + Wheel Zooms, Drag PansenabledOn / off

    Footnotefootnote

    SettingType and options
    ShowshowOn / off
    SourcesourceText
    State the MethodsshowMethodOn / off
    Font SizefontSizeNumber
    Text ColourcolorColour

    Tabs and Buttonscontrols

    SettingType and options
    Font SizefontSizeNumber
    Text ColourcolorColour

    Accessibilityaccessibility

    SettingType and options
    Patterns (Tell Items Apart Without Colour)patternsOn / off
    Focus Outline ColourfocusColorColour
    Focus Outline WidthfocusWidthNumber
    Minimum Text Size (0 = off)minFontSizeNumber
    Reduce MotionreduceMotionOn / off

    Themetheme

    SettingType and options
    ThemeselectedTheme
    • SmartVisuals smartvisuals
    • Dark dark
    • Clean (White) clean
    • Slate slate
    Fontfont
    • Inter inter
    • Segoe UI segoe
    • Arial arial
    • Georgia georgia
    Transparent BackgroundtransparentBgOn / off

    Data ColoursdataPoint

    SettingType and options
    ColourfillColour

    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" } } }
          }
        }]
      }
    }