# SmartVisuals Part-to-Whole for Power BI

> Power BI part-to-whole visual: pie and donut, rose, radial bar, waffle, pictogram, funnel and Marimekko from one set of fields, with share shift vs last year.

- Page: https://www.smartvisuals.io/visuals/part-to-whole
- Fields and settings: https://www.smartvisuals.io/visuals/part-to-whole/settings
- Microsoft Marketplace: https://marketplace.microsoft.com/en-us/product/smartvisuals.smartvisuals-part-to-whole?tab=overview
- Package: https://www.smartvisuals.io/downloads/smartvisuals-part-to-whole-1.0.0.0.pbiviz
- Price: Free tier for every viewer; premium $4.49 per user per month or $45 per user per year on Microsoft Marketplace, with a 30-day free trial. Premium works in edit mode without a licence; unlicensed viewers see the free tier, never a blocked visual.
- Certified by Microsoft: no
- Version: 1.0.0.0
- GUID (visualType and publicCustomVisuals): `smartvisualsPartToWhole553C74E0A67D23C286D3CA02B73AF59F`

## What is free

- **Seven views, one set of fields**: Pie & Donut, Rose, Radial Bar, Waffle, Pictogram, Funnel & Pyramid and Marimekko, switched with tabs in the visual or with View > Chart in the format pane.
- **Honest defaults**: Sorted from 12 o'clock, the long tail in a labelled Other with its members on hover, labels rounded by largest remainder so they add up to 100 %, rose petals sized by area, negatives and blanks counted in the footnote.
- **Pie and donut**: Semicircle, 270 degrees or a custom arc, gaps, rounded corners, the selected slice pulled out, nested rings, bar of pie, spotlight, centre total, and small multiples (free in this view).
- **Rose and radial bar**: Rose by area, by radius or aster, stacked petals, month, weekday, hour and compass order, a radial axis; radial bars on a shared maximum, progress rings to each target, met or missed by colour and symbol, status bands (targets free in this view).
- **Waffle and pictogram**: Percent and unit grids, built-in icons or your own SVG path, isotype rows, icon arrays, a parliament with a majority line, an infographic card and a target (free in these views).
- **Funnel and Marimekko**: A Stage order field, % of first and of previous stage, drop and lost, conversion pills, leak ribbons, stacked segments and pyramids; Marimekko as 100 % or actual values, a Width measure, horizontal or vertical, Top N + Other per column and a cost curve.
- **Smart caption, footnote and data table**: A one-sentence caption ("Chicago is the largest share at 30 %. The top three make up 53 %."), a methods footnote and an accessible data table one button away.
- **Power BI features**: Tooltips and report page tooltips, highlight and cross-filter with Ctrl to add, bookmarks, context menu, drilldown, conditional formatting (fx), colour rules by value, share or rank, a show condition and a centre value measure.
- **Templates, themes and on-object formatting**: Six templates (Executive, IBCS (Finance), Minimal, Presentation, Print, Infographic), four themes, four fonts, format on the canvas, and a responsive layout that drops whole labels instead of overlapping them.
- **Accessibility**: One keyboard tab stop with arrow keys, a screen-reader live region, high contrast with fill patterns, focus outline, minimum text size and Reduce motion, in 20 languages.

## What premium adds

- **Compare in every view**: Last period or plan as a ring, an outline, a ghost arc or gained and lost cells, with the share shift in points over each period's own total.
- **The mix review (pie and donut)**: A share bridge of the points won and lost, volume vs mix vs price, targets per slice, a test of the change in mix, HHI and top-3 change, and play over periods.
- **Where will we land? (radial bar and rose)**: Pace and projected landing, the run rate each ring needs, last period's ghost arc; past seasons as fading outlines and seasonality findings in the rose.
- **Pipeline, market map and survey analysis**: Funnel conversion vs last period or plan with a z-test per step, expected value, coverage and what-if; Marimekko share shift, segment CAGR, relative market share and the cost-curve demand line; survey margins of error, wave tests, seat change and a coalition builder.
- **Mosaic**: Two to four views side by side over the same fields, with one caption and one legend.
- **Findings and small multiples**: Up to five findings with how each was calculated, and small multiples in every view (they are free in the pie view).

## Fields

| Field | Internal name | Takes | Needed | What it is for |
| --- | --- | --- | --- | --- |
| Category | `category` | Column | Optional | The parts: slices, petals, rings, cells, icons, stages or columns |
| Segment | `segment` | Column | Optional | A second split: an outer ring, stacked petals or stages, Marimekko rows, waffle colours |
| Values | `values` | Measure | Optional | The size of each part |
| Compare | `compare` | Measure | Optional | Last period, plan or any reference: share shift, ghost marks, findings (premium) |
| Target | `target` | Measure | Optional | A goal per part |
| Width | `width` | Measure | Optional | Column width (else each column's total) |
| Angle (aster) | `angle` | Measure | Optional | Petal angle in the aster layout |
| Stage order | `stageOrder` | Measure | Optional | Sort key of the stages (1, 2, 3...) |
| Win probability | `probability` | Measure | Optional | Chance each stage closes (0-1 or %): weighted pipeline (premium) |
| Units | `units` | Measure | Optional | Quantities behind Values: splits the change into volume, mix and price (premium) |
| Compare units | `compareUnits` | Measure | Optional | Quantities behind Compare (premium) |
| Sample size | `sampleSize` | Measure | Optional | Respondents behind each share: margin of error (premium) |
| Effective base | `effectiveBase` | Measure | Optional | Kish effective base of weighted data, (Σw)² / Σw² (premium) |
| Period elapsed | `elapsed` | Measure | Optional | Share of the period gone (0-1 or %): pace and landing (premium) |
| Plan to date | `planToDate` | Measure | Optional | Where the actual should be today, if not linear (premium) |
| Icon | `icon` | Measure | Optional | Built-in icon name, SVG path or data:image URI per part |
| Annotation | `annotation` | Measure | Optional | Text measure: a callout on the part |
| Play axis | `play` | Column | Optional | Periods to play through (premium) |
| Seasons | `season` | Column | Optional | Periods such as years: the latest is drawn, the past ones as outlines behind it (premium) |
| Small multiples | `facet` | Column | Optional | One chart per value |
| Tooltips | `tooltips` | Measure | Optional | Extra fields in tooltips |
| Centre value | `centreValue` | Measure | Optional | Shown in the centre instead of the total (a ratio: make every part return the same value, e.g. with ALLSELECTED) |
| Loss reason | `lossReason` | Column | Optional | Why the lost left each step (blank = still open or won): splits the leak ribbons by reason (premium) |
| Show condition | `showCondition` | Measure | Optional | A measure returning 1 / TRUE to show the chart, 0 / FALSE / blank to show a message instead |
| Compare base | `compareBase` | Measure | Optional | Effective base (or sample size) of the Compare wave: the wave test uses it instead of the current base (premium) |

## Format pane

Each card is a key under `visual.objects` in a PBIR visual.json; each setting is a property of it. Toggles take `true`/`false`, choices and text a value in single quotes (`'auto'`), numbers a `D` suffix (`12D`).

### View (`view`)

| Setting | Internal name | Type or options |
| --- | --- | --- |
| Chart | `type` | `pie` (Pie & Donut), `rose` (Rose), `radial` (Radial Bar), `waffle` (Waffle), `pictogram` (Pictogram), `funnel` (Funnel & Pyramid), `marimekko` (Marimekko) |
| Show View Tabs | `showTabs` | On / off |
| Mosaic (2-4 Views Side by Side) | `mosaic` | On / off |
| Mosaic View 1 | `mosaic1` | `pie` (Pie & Donut), `rose` (Rose), `radial` (Radial Bar), `waffle` (Waffle), `pictogram` (Pictogram), `funnel` (Funnel & Pyramid), `marimekko` (Marimekko) |
| Mosaic View 2 | `mosaic2` | `pie` (Pie & Donut), `rose` (Rose), `radial` (Radial Bar), `waffle` (Waffle), `pictogram` (Pictogram), `funnel` (Funnel & Pyramid), `marimekko` (Marimekko) |
| Mosaic View 3 | `mosaic3` | `pie` (Pie & Donut), `rose` (Rose), `radial` (Radial Bar), `waffle` (Waffle), `pictogram` (Pictogram), `funnel` (Funnel & Pyramid), `marimekko` (Marimekko), `none` ((none)) |
| Mosaic View 4 | `mosaic4` | `pie` (Pie & Donut), `rose` (Rose), `radial` (Radial Bar), `waffle` (Waffle), `pictogram` (Pictogram), `funnel` (Funnel & Pyramid), `marimekko` (Marimekko), `none` ((none)) |

### Templates (`templates`)

| Setting | Internal name | Type or options |
| --- | --- | --- |
| Style Template | `preset` | `none` (None (style defaults)), `executive` (Executive), `ibcs` (IBCS (Finance)), `minimal` (Minimal), `presentation` (Presentation), `print` (Print), `infographic` (Infographic), `custom` (Custom) |
| Applied | `applied` | Text |

### Pie & Donut (`pie`)

| Setting | Internal name | Type or options |
| --- | --- | --- |
| Shape | `shape` | `donut` (Donut), `pie` (Pie) |
| Hole Size (%) | `innerRadius` | Number |
| Arc | `arc` | `full` (Full circle), `semi` (Semicircle), `threeQuarter` (Three quarters (270°)), `custom` (Custom start and sweep) |
| Start Angle (°) | `startAngle` | Number |
| Sweep (°) | `sweep` | Number |
| Gaps Between Slices | `gap` | `theme` (From theme), `none` (None), `small` (Small), `large` (Large) |
| Corners | `corners` | `theme` (From theme), `square` (Square), `rounded` (Rounded) |
| Pull Out the Selected Slice | `explode` | On / off |
| Segment Field As | `nested` | `ring` (Outer ring (nested donut)), `shades` (Shades inside each slice), `ignore` (Ignore) |
| Segment Names on the Ring | `segmentLabels` | On / off |
| Bar of Pie (Expand Other) | `barOfPie` | On / off |
| Spotlight | `spotlight` | `none` (None), `largest` (The largest slice), `named` (A slice by name) |
| Spotlight Slice | `spotlightName` | Text |
| Images in Slices | `images` | On / off |
| Depth Style (no tilt) | `depth` | On / off |

### Rose (`rose`)

| Setting | Internal name | Type or options |
| --- | --- | --- |
| Petal Size | `mode` | `area` (By area (honest)), `radius` (By radius), `aster` (Aster: angle from a second measure) |
| Arc | `arc` | `full` (Full circle), `semi` (Semicircle), `threeQuarter` (Three quarters (270°)), `custom` (Custom start and sweep) |
| Start Angle (°) | `startAngle` | Number |
| Sweep (°) | `sweep` | Number |
| Inner Radius (%) | `innerRadius` | Number |
| Stack Petals by Segment | `stacked` | On / off |
| Order | `order` | `auto` (Auto (months, weekdays, hours, compass)), `calendar` (Calendar (months, quarters)), `weekday` (Weekdays (Monday first)), `hour` (Hours of the day (midnight at the top)), `compass` (Compass points (north at the top)), `sort` (As the Sorting card) |
| Calendar Order for Months and Days | `calendar` | On / off |
| Past Seasons as Outlines | `seasons` | Number |
| Images in Petals | `images` | On / off |
| Gaps Between Petals | `gap` | `theme` (From theme), `none` (None), `small` (Small), `large` (Large) |

### Radial Axis (`radialAxis`)

| Setting | Internal name | Type or options |
| --- | --- | --- |
| Grid Circles | `show` | On / off |
| Axis Values | `labels` | On / off |
| Number of Circles | `count` | Number |
| Maximum (0 = auto) | `max` | Number |
| Grid Colour | `color` | Colour |

### Radial Bar (`radial`)

| Setting | Internal name | Type or options |
| --- | --- | --- |
| Layout | `mode` | `auto` (Auto (rings when a target is set)), `bars` (Radial bars (shared maximum)), `rings` (Progress rings (each to its target)), `single` (Single ring (KPI)) |
| Arc | `arc` | `threeQuarter` (Three quarters (270°)), `full` (Full circle), `semi` (Semicircle) |
| Start Angle (°) | `startAngle` | Number |
| Inner Radius (%) | `innerRadius` | Number |
| Gap Between Rings (%) | `gap` | Number |
| Track | `track` | On / off |
| Bar Ends | `caps` | `theme` (From theme), `round` (Rounded), `square` (Square) |
| Ring Labels | `labelPosition` | `start` (At the start of each ring), `end` (At the end of each bar), `none` (None) |
| Depth Style (no tilt) | `depth` | On / off |
| Status Bands on the Track | `bands` | On / off |

### Waffle (`waffle`)

| Setting | Internal name | Type or options |
| --- | --- | --- |
| Grid | `grid` | `percent` (Percent grid (each cell = 1 %)), `unit` (Unit grid (each cell = N units)) |
| Rows | `rows` | Number |
| Columns | `columns` | Number |
| Units per Cell (0 = auto) | `unitValue` | Number |
| Layout | `layout` | `stacked` (One grid, all categories), `perCategory` (One grid per category) |
| Fill Direction | `fill` | `row` (Row by row), `column` (Column by column), `snake` (Snake) |
| Cell Shape | `cellShape` | `theme` (From theme), `square` (Square), `rounded` (Rounded square), `circle` (Circle (dot matrix)), `icon` (Icon) |
| Icon | `icon` | `person` (Person), `people` (People), `woman` (Woman), `man` (Man), `building` (Building), `factory` (Factory), `house` (House), `box` (Box), `truck` (Truck), `car` (Car), `cart` (Shopping cart), `dollar` (Dollar), `euro` (Euro), `coin` (Coin), `heart` (Heart), `star` (Star), `leaf` (Leaf), `drop` (Water Drop), `bolt` (Bolt), `laptop` (Laptop), `phone` (Phone), `seat` (Seat), `check` (Check mark), `circle` (Circle), `square` (Square) |
| Custom Icon (SVG path or data:image) | `customIcon` | Text |
| Cell Gap (%) | `gap` | Number |
| Headline Number | `headline` | On / off |
| Headline Shows | `headlineFocus` | `largest` (The largest category), `first` (The first category) |
| Empty Cell Colour | `emptyColor` | Colour |
| Show “1 cell = N” Under the Grid | `unitNote` | On / off |
| Show “% of Target” in the Labels | `targetText` | On / off |
| Fill-In Animation | `fillIn` | On / off |
| Hover Spotlight | `spotlight` | On / off |

### Pictogram (`pictogram`)

| Setting | Internal name | Type or options |
| --- | --- | --- |
| Layout | `mode` | `isotype` (Isotype rows (one row per category)), `array` (Icon array (one block)), `parliament` (Parliament (hemicycle)), `card` (Infographic card (one icon filled to %)) |
| Icon | `icon` | `person` (Person), `people` (People), `woman` (Woman), `man` (Man), `building` (Building), `factory` (Factory), `house` (House), `box` (Box), `truck` (Truck), `car` (Car), `cart` (Shopping cart), `dollar` (Dollar), `euro` (Euro), `coin` (Coin), `heart` (Heart), `star` (Star), `leaf` (Leaf), `drop` (Water Drop), `bolt` (Bolt), `laptop` (Laptop), `phone` (Phone), `seat` (Seat), `check` (Check mark), `circle` (Circle), `square` (Square) |
| Custom Icon (SVG path or data:image) | `customIcon` | Text |
| Units per Icon (0 = auto) | `unitValue` | Number |
| Icons per Row (0 = auto) | `perRow` | Number |
| Parliament Shape | `span` | `semicircle` (Semicircle), `arch` (Arch (240°)), `full` (Full circle) |
| Majority | `majority` | `simple` (Simple majority (> 50 %)), `twoThirds` (Two thirds), `threeFifths` (Three fifths), `quota` (Typed quota), `none` (None) |
| Seats Needed | `quota` | Number |
| Card Reads | `cardStyle` | `share` (Share (e.g. 34 %)), `oneIn` (One in N), `progress` (Progress to target) |
| Empty Icon Colour | `emptyColor` | Colour |
| Seat Total in the Centre | `readout` | On / off |
| Card Caption | `cardCaption` | On / off |
| Fill-In Animation | `fillIn` | On / off |
| Hover Spotlight | `spotlight` | On / off |

### Funnel & Pyramid (`funnel`)

| Setting | Internal name | Type or options |
| --- | --- | --- |
| Chart | `style` | `funnel` (Funnel), `pyramid` (Pyramid), `inverted` (Inverted pyramid) |
| Orientation | `orientation` | `vertical` (Vertical), `horizontal` (Horizontal) |
| Shape | `shape` | `tapered` (Tapered), `bars` (Straight bars), `curved` (Curved) |
| Level Heights | `heights` | `equal` (Equal), `proportional` (Proportional to value) |
| Connector Areas | `connectors` | On / off |
| Minimum Stage Width (%) | `minWidth` | Number |
| Segment Field As | `segments` | `stacked` (Stacked inside each stage), `sideBySide` (Side by side (one funnel per segment)) |
| Conversion Pills | `pills` | On / off |
| Leak Ribbons (What Each Step Loses) | `leaks` | On / off |
| Leak Ribbon Labels | `leakLabels` | On / off |
| Lane Titles | `laneTitles` | On / off |
| % of First Stage | `showPctFirst` | On / off |
| % of Previous Stage | `showPctPrevious` | On / off |
| Drop % | `showDrop` | On / off |
| Lost (Absolute) | `showLoss` | On / off |
| Data Checks (edit mode) | `diagnostics` | On / off |

### Marimekko (`marimekko`)

| Setting | Internal name | Type or options |
| --- | --- | --- |
| Chart | `mode` | `percent` (100 % Marimekko), `actual` (Actual values (bar Mekko)), `costCurve` (Cost curve (variable-width bars by height)) |
| Orientation | `orientation` | `vertical` (Vertical columns), `horizontal` (Horizontal bars) |
| Sort Columns | `sortColumns` | `desc` (Largest first), `asc` (Smallest first), `name` (Name), `data` (Data order) |
| Sort Segments | `sortSegments` | `desc` (Largest first (per column)), `global` (Same order in every column), `name` (Name), `data` (Data order) |
| Top N Segments per Column (0 = automatic) | `topSegments` | Number |
| Fold Small Players into Other | `autoOther` | On / off |
| Labels Outside Thin Cells | `outsideLabels` | On / off |
| Column Labels | `columnLabels` | On / off |
| Column Totals | `columnTotals` | On / off |
| Cell Percentages | `cellPercent` | `column` (% of column), `total` (% of total) |
| Hide Labels in Cells Below (% of area) | `minLabelShare` | Number |
| Value Axis | `percentAxis` | On / off |
| Column Axis Title | `xTitle` | Text |
| Value Axis Title | `yTitle` | Text |
| Relative Market Share | `relativeShare` | On / off |
| Focus Player | `focusPlayer` | Text |
| Where Is the Prize | `prize` | On / off |
| Prize Labels | `prizeLabels` | On / off |
| Prize: Up to a Share of (%, 0 = whole market) | `prizeShare` | Number |
| Cost Curve: Demand (0 = off) | `threshold` | Number |
| Demand Line Label | `demandLabel` | On / off |
| % of Target Above Columns | `targetBand` | On / off |

### Sorting and Other (`sorting`)

| Setting | Internal name | Type or options |
| --- | --- | --- |
| Sort | `sort` | `desc` (Largest first), `asc` (Smallest first), `name` (Name), `data` (Data order), `order` (Stage order field) |
| Readers Can Change the Sort | `readerSort` | On / off |
| Group Small Items Into Other | `other` | On / off |
| Show at Most (items) | `maxItems` | Number |
| Group Items Below (%) | `minShare` | Number |
| Other Label | `otherLabel` | Text |

### Data Labels (`labels`)

| Setting | Internal name | Type or options |
| --- | --- | --- |
| Show | `show` | On / off |
| Content | `content` | `category` (Category), `value` (Value), `percent` (Percent of total), `categoryPercent` (Category, percent), `categoryValue` (Category, value), `valuePercent` (Value, percent), `all` (Category, value, percent) |
| Position | `position` | `auto` (Auto), `inside` (Inside), `outside` (Outside with leader lines) |
| Percent Decimals | `percentDecimals` | Number |
| Display Units | `displayUnits` | `auto` (Auto), `none` (None), `K` (Thousands), `M` (Millions), `B` (Billions) |
| Value Decimals (-1 = auto) | `valueDecimals` | Number |
| Hide Labels Below (%) | `hideBelow` | Number |
| Font Size | `fontSize` | Number |
| Text Colour | `color` | Colour |
| Detail Text Size | `detailSize` | Number |
| Detail Text Colour | `detailColor` | Colour |

### Centre (`centre`)

| Setting | Internal name | Type or options |
| --- | --- | --- |
| Show | `show` | On / off |
| Content | `content` | `total` (Total), `hover` (Hovered item, else total), `largest` (Largest item's share) |
| Caption Under the Value | `label` | Text |
| Value Font Size (0 = auto) | `fontSize` | Number |
| Text Colour | `color` | Colour |

### Legend (`legend`)

| Setting | Internal name | Type or options |
| --- | --- | --- |
| Show | `show` | On / off |
| Position | `position` | `auto` (Auto (only when labels do not name the items)), `top` (Top), `bottom` (Bottom), `right` (Right), `left` (Left) |
| Font Size | `fontSize` | Number |
| Text Colour | `color` | Colour |

### Colour Rules (`colorRules`)

| Setting | Internal name | Type or options |
| --- | --- | --- |
| Rule | `mode` | `none` (None (one colour per item)), `rank` (Highlight the top N), `value` (Above / below a value), `share` (Above / below a share (%)) |
| Top N | `topN` | Number |
| Threshold | `threshold` | Number |
| Highlight / Above Colour | `highColor` | Colour |
| Others / Below Colour | `lowColor` | Colour |

### Compare (`compare`)

| Setting | Internal name | Type or options |
| --- | --- | --- |
| Show the Comparison | `show` | On / off |
| Comparison Name | `name` | Text |
| Change Labels | `labels` | `pp` (Share shift (pp)), `value` (Value change), `percent` (% change), `none` (None) |
| Draw the Comparison (ghost) | `ghost` | On / off |
| Sort by Change | `sortByChange` | On / off |
| Volume vs Mix Split | `volumeMix` | On / off |
| Concentration (HHI, top 3) | `concentration` | On / off |
| Share Bridge (points won and lost) | `shareBridge` | On / off |
| Movers in the Bridge | `bridgeItems` | Number |
| Segment CAGR Above Columns | `cagr` | On / off |
| Years Between the Periods | `years` | Number |

### Targets (`targets`)

| Setting | Internal name | Type or options |
| --- | --- | --- |
| Show Targets | `show` | On / off |
| One Target for All (0 = off) | `global` | Number |
| Met at (% of target) | `metAt` | Number |
| Close at (% of target) | `closeAt` | Number |
| Met Colour | `metColor` | Colour |
| Close Colour | `closeColor` | Colour |
| Missed Colour | `missedColor` | Colour |
| Colour Items by Status | `statusColors` | On / off |

### Pace (`pace`)

| Setting | Internal name | Type or options |
| --- | --- | --- |
| Show Pace | `show` | On / off |
| Share of Period Elapsed (%, 0 = from the field or dates) | `elapsed` | Number |
| Period Start (yyyy-mm-dd) | `periodStart` | Text |
| Period End (yyyy-mm-dd) | `periodEnd` | Text |
| On Track Within (%) | `tolerance` | Number |
| Projected Landing | `projection` | On / off |
| Required Run Rate | `runRate` | On / off |
| Run Rate per | `unit` | `month` (Month), `week` (Week), `quarter` (Quarter), `day` (Day) |
| Units in the Whole Period (0 = a year, or from the dates) | `units` | Number |

### Significance (`significance`)

| Setting | Internal name | Type or options |
| --- | --- | --- |
| Test the Change | `show` | On / off |
| Significance Level | `alpha` | `0.05` (95 % (α = 0.05)), `0.01` (99 % (α = 0.01)), `0.1` (90 % (α = 0.10)) |
| Values Are | `valuesAre` | `auto` (Automatic (whole numbers, not currency or %)), `counts` (Counts (opportunities, people, orders)), `amounts` (Amounts (revenue, value): not tested) |
| Test Against | `reference` | `compare` (The Compare field), `firstSegment` (The first segment) |

### Survey Margins (`survey`)

| Setting | Internal name | Type or options |
| --- | --- | --- |
| Show the Margin of Error | `show` | On / off |
| Confidence | `confidence` | `0.95` (95 %), `0.9` (90 %), `0.99` (99 %) |
| Interval | `method` | `wilson` (Wilson), `normal` (Normal (Wald)) |
| Margin Text in the Labels | `marginText` | On / off |
| Test the Change vs the Compare Wave | `waveTest` | On / off |
| Plan the Next Wave: Margin Wanted (± pp, 0 = off) | `planMargin` | Number |
| Plan For | `planShare` | `worst` (Every share (worst case p = 0.5)), `observed` (Each observed share) |

### Coalition Builder (`coalition`)

| Setting | Internal name | Type or options |
| --- | --- | --- |
| Show Coalitions | `show` | On / off |
| Parties in the Coalition | `parties` | Text |
| List Minimal Winning Coalitions | `list` | On / off |
| Seat Sum Readout | `readout` | On / off |

### Pipeline & Forecast (`pipeline`)

| Setting | Internal name | Type or options |
| --- | --- | --- |
| Show Expected Value | `show` | On / off |
| Stages Are | `stagesAre` | `cumulative` (Cumulative (each stage counts everyone who reached it)), `inStage` (In stage (each stage counts only those there now)) |
| Last Stage Is Won (counted at 100 %) | `lastIsWon` | On / off |
| Pipeline Coverage | `coverage` | `off` (Off), `forecast` (Forecast (expected + won) ÷ quota), `open` (Open pipeline ÷ quota) |
| Quota (0 = the last stage's Target) | `quota` | Number |
| Forecast Line Under the Chart | `totalLine` | On / off |

### What If (`whatIf`)

| Setting | Internal name | Type or options |
| --- | --- | --- |
| Lift One Step | `show` | On / off |
| Step Into Stage (blank = the weakest step) | `step` | Text |
| Uplift (percentage points) | `uplift` | Number |
| Uplift Labels | `showText` | On / off |

### Play Over Periods (`play`)

| Setting | Internal name | Type or options |
| --- | --- | --- |
| Seconds per Period | `speed` | Number |
| Loop | `loop` | On / off |

### Findings (`findings`)

| Setting | Internal name | Type or options |
| --- | --- | --- |
| What Changed (findings) | `show` | On / off |
| Number of Findings | `max` | Number |
| Font Size | `fontSize` | Number |
| Text Colour | `color` | Colour |

### Smart Caption (`caption`)

| Setting | Internal name | Type or options |
| --- | --- | --- |
| Show | `show` | On / off |
| Position | `position` | `top` (Top), `bottom` (Bottom) |
| Font Size | `fontSize` | Number |
| Text Colour | `color` | Colour |

### Small Multiples (`smallMultiples`)

| Setting | Internal name | Type or options |
| --- | --- | --- |
| Columns (0 = auto) | `columns` | Number |
| Shared Scale | `sharedScale` | On / off |
| Size Pies by Their Total | `sizeByTotal` | On / off |
| Title Font Size | `titleSize` | Number |
| Title Colour | `titleColor` | Colour |

### Annotations (`annotations`)

| Setting | Internal name | Type or options |
| --- | --- | --- |
| Show | `show` | On / off |
| Font Size | `fontSize` | Number |
| Colour | `color` | Colour |

### Show Condition (`showCondition`)

| Setting | Internal name | Type or options |
| --- | --- | --- |
| Message When Hidden | `message` | Text |

### Data Table (`dataTable`)

| Setting | Internal name | Type or options |
| --- | --- | --- |
| Table Button in the Visual | `button` | On / off |
| Open as Table | `start` | On / off |

### Zoom (`zoom`)

| Setting | Internal name | Type or options |
| --- | --- | --- |
| Ctrl + Wheel Zooms, Drag Pans | `enabled` | On / off |

### Footnote (`footnote`)

| Setting | Internal name | Type or options |
| --- | --- | --- |
| Show | `show` | On / off |
| Source | `source` | Text |
| State the Methods | `showMethod` | On / off |
| Font Size | `fontSize` | Number |
| Text Colour | `color` | Colour |

### Axis Text (`axes`)

| Setting | Internal name | Type or options |
| --- | --- | --- |
| Show Axis Values and Titles | `show` | On / off |
| Font Size | `fontSize` | Number |
| Text Colour | `color` | Colour |

### Tabs and Buttons (`controls`)

| Setting | Internal name | Type or options |
| --- | --- | --- |
| Font Size | `fontSize` | Number |
| Text Colour | `color` | Colour |

### Accessibility (`accessibility`)

| Setting | Internal name | Type or options |
| --- | --- | --- |
| Patterns (Tell Items Apart Without Colour) | `patterns` | On / off |
| Focus Outline Colour | `focusColor` | Colour |
| Focus Outline Width | `focusWidth` | Number |
| Minimum Text Size (0 = off) | `minFontSize` | Number |
| Reduce Motion | `reduceMotion` | On / off |

### Theme (`theme`)

| Setting | Internal name | Type or options |
| --- | --- | --- |
| Theme | `selectedTheme` | `smartvisuals` (SmartVisuals), `dark` (Dark), `clean` (Clean (White)), `slate` (Slate) |
| Font | `font` | `inter` (Inter), `segoe` (Segoe UI), `arial` (Arial), `georgia` (Georgia) |
| Transparent Background | `transparentBg` | On / off |

### Data Colours (`dataPoint`)

| Setting | Internal name | Type or options |
| --- | --- | --- |
| Colour | `fill` | Colour |

### Category Icons (`categoryIcon`)

| Setting | Internal name | Type or options |
| --- | --- | --- |
| Icon | `icon` | Text |
