# SmartVisuals Pie & Donut for Power BI

> Power BI pie and donut chart: sorted slices, Top N + Other with its members, labels that add to 100 %, bar of pie, nested donut, free small multiples, share shift.

- Page: https://www.smartvisuals.io/visuals/pie-donut
- Fields and settings: https://www.smartvisuals.io/visuals/pie-donut/settings
- Microsoft Marketplace: https://marketplace.microsoft.com/en-us/product/smartvisuals.smartvisuals-pie-donut?tab=overview
- Package: https://www.smartvisuals.io/downloads/smartvisuals-pie-donut-1.0.0.0.pbiviz
- Price: Free tier for every viewer; premium $1.99 per user per month or $19 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): `smartvisualsPieDonutDA5731150FF19D2748671B258AC9657A`

## What is free

- **Honest by default**: Slices sorted from 12 o'clock, labels rounded by largest remainder so they add up to 100 %, negatives and blanks counted in the footnote instead of silently dropped.
- **Top N + Other**: Show at Most or Group Items Below (%), with Other's members listed on hover and in the data table.
- **Shapes**: Pie, donut, semicircle, 270 degrees or a custom arc; start angle, gaps, rounded corners and the selected slice pulled out.
- **Bar of pie and nested donut**: Bar of pie breaks Other out into a bar; Segment draws an outer ring or shades inside each slice.
- **Labels and centre**: Inside, outside or auto with leader lines; labels that do not fit are dropped whole. The centre shows the total, the hovered slice, the largest share or a measure of your own.
- **Small multiples, free**: One donut per region or quarter with a shared legend, each panel's total in the centre, optionally sized by its total.
- **Spotlight**: Pull out the largest slice or one by name and mute the rest; the donut names it in the centre.
- **Colour and images**: A colour per category, conditional formatting (fx), colour rules by value, share or rank, fill patterns, images in slices from an Icon field, and a straight-on depth style (no 3D tilt).
- **Smart caption and footnote**: "Chicago is the largest share at 30 %. The top three make up 53 %." and a footnote that says how the numbers were made.
- **Power BI features**: Tooltips and report page tooltips, highlight and cross-filter with Ctrl to add, bookmarks, context menu, drilldown, a show condition, six templates, four themes, four fonts, on-object formatting and 20 languages.

## What premium adds

- **Last period's ring and share shift**: Last year's or the plan's ring around this year's, the share shift in points on every slice, and slices that entered or left.
- **Share bridge**: A waterfall of share points from last period's mix to this one, biggest movers first.
- **Volume vs mix vs price**: How much of the change came from the whole growing and how much from the mix moving, in currency, with price split out when Units are bound.
- **Targets per slice**: Budget vs actual: a tick where each slice's budget sits, a met, close or missed band and the % of target on the label.
- **Significance of the shift**: Chi-square on the composition and a z-test per slice when the measure is a count; amounts are never tested as counts.
- **Concentration, play and findings**: HHI and top-3 share change vs last period, play over periods, and up to five findings with how each was calculated.

## 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 |
| 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) |
| 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) |
| 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) |
| Show condition | `showCondition` | Measure | Optional | A measure returning 1 / TRUE to show the chart, 0 / FALSE / blank to show a message instead |

## 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`).

### 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 |

### 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 |

### 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) |

### 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 |

### 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 |
