# SmartVisuals Sankey for Power BI

> Sankey for Power BI from Source and Destination pairs or a flat table of stages. Colours stay put under filters, loops drawn as loops. Free up to 40 nodes.

- Page: https://www.smartvisuals.io/visuals/sankey
- Fields and settings: https://www.smartvisuals.io/visuals/sankey/settings
- Microsoft Marketplace: https://marketplace.microsoft.com/en-us/product/smartvisuals.smartvisuals-sankey?tab=overview
- Package: https://www.smartvisuals.io/downloads/smartvisuals-sankey-1.0.0.0.pbiviz
- Sample report (zipped .pbip): https://www.smartvisuals.io/samples/smartvisuals-sankey-sample-1.0.0.0.zip
- 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): `smartVisualsSankey7C41D2E09B8A4F6E9D3A51C2B7E04F18`

## What is free

- **Pairs or a flat table**: Source and Destination pairs at any depth, or a flat table with up to three stage columns, up to 40 nodes. The visual builds the columns itself.
- **Blank stages and loops**: Blank stages skipped, shown as (Blank) so you see where paths stop, or ending the path. Loops (rework, recovery, returns) drawn as arcs, never as duplicated nodes.
- **Correct numbers**: Zero flows are never drawn as 1, negative values are never silently made positive, and a status line says what was hidden and why.
- **Stable colours and conditional formatting**: Colours keyed to the node name, a colour picker per node under its real name, plus conditional formatting (fx) on node and link colours.
- **Node icons and notes**: An icon from a built-in set of 20 and a note under any node, picked by node name.
- **Links your way**: Gradient, source, destination or one link colour, arrowheads, curvature and opacity.
- **Labels in your model's format**: Value and percentage labels (of the total, the column or the largest source) with the model's format string and display units. Labels that do not fit hide instead of overlapping.
- **Trace, cross-filter, tooltips**: Hover or click to trace a node's whole path, cross-filtering, highlight from other visuals, bookmarks, tooltips and report page tooltips.
- **Order you control**: Sort by fewest crossings, size, A to Z or data order, or drag nodes into a custom order that is saved with the report.
- **Layout**: Column headers, left to right or top to bottom, and a compact mode for small tiles.
- **On-object formatting and style templates**: Format nodes, links, labels and headers on the canvas, and copy a style code from one Sankey into another.
- **Four themes**: SmartVisuals, Dark, Clean and Slate, each with its own personality, plus report theme colours and high contrast.
- **Accessibility and 20 languages**: Keyboard navigation, screen reader labels and an accessible data table of every flow, in 20 languages.

## What premium adds

- **Long journeys, Top N and Other**: Customer journeys with four to ten stage columns, and Top N per column or merging small nodes into Other to keep a big chart readable.
- **Beyond 40 nodes**: The complete chart beyond 40 nodes, for cost allocations, budgets and energy balances.
- **Who dropped off**: Drop-off and entry nodes counted exactly from each path; click one to filter the report to the rows behind it.
- **Volume-share trace**: The exact part of a node's volume that reaches every later stage, with its share on each node.
- **Compare two periods or a budget**: New, lost, grown and shrunk flows and a strip of the biggest changes.
- **Alluvial over time**: From a date or period column, with the same category order in every period.
- **Small multiples**: The same colours and order in every panel, with drilldown through a Split By hierarchy.
- **Before and after**: The same categories on both sides (tiers, segments) with one colour each, and stayed flows muted or hidden.
- **Insights**: Bottlenecks, unusual flows, drop-off share and the biggest change in plain sentences; click one to trace it.
- **Export to Excel or CSV**: The flows and nodes as a workbook or the flows as CSV. Needs the tenant setting that allows downloads from custom visuals.
- **Finance mode and collapse**: Negative values drawn as loss flows, and a double click collapses everything downstream of a node.

## Fields

| Field | Internal name | Takes | Needed | What it is for |
| --- | --- | --- | --- | --- |
| Source | `source` | Column | Optional | Where a flow starts. Use with Destination when your table holds pairs (any depth). |
| Destination | `destination` | Column | Optional | Where a flow goes. A node can be a destination and a source: the visual builds the levels. |
| Stages (in order) | `stages` | Column | Optional, up to 10 | A flat table: one column per stage, left to right (channel, first order, status). No reshaping needed. Up to 10 stages. |
| Amount | `amount` | Measure | Optional | The size of each flow. Without it, flows count rows. |
| Compare With (Premium) | `compareAmount` | Measure | Optional | Budget, prior period or scenario. Shows what changed per flow (Premium). |
| Period (Premium) | `period` | Column | Optional | A date or period column. With one stage it draws an alluvial over time; otherwise it compares the latest two periods (Premium). |
| Split By (Premium) | `split` | Column | Optional | One small Sankey per value, same colors and order in every panel (Premium). Bind a hierarchy (Region, Country) to drill the panels down. |
| Color By | `colorBy` | Column | Optional | Colors nodes by this attribute (region, type) instead of by node name. |
| Tooltips | `tooltips` | Measure | Optional, up to 5 | Extra fields for the tooltip. |

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

### Flow (`flow`)

| Setting | Internal name | Type or options |
| --- | --- | --- |
| Data Shape | `mode` | `auto` (Automatic), `pairs` (Pairs (Source and Destination)), `journey` (Flat Table (Stages)), `migration` (Before and After (Premium)) |
| Orientation | `orientation` | `horizontal` (Left to Right), `vertical` (Top to Bottom) |
| Align Nodes | `align` | `left` (From the Start), `right` (To the End), `justify` (Endpoints at the End) |
| Blank Stages | `blankStages` | `skip` (Skip the Stage), `blank` (Show as (Blank)), `end` (End the Path) |
| Loops | `loops` | `arcs` (Draw as Arcs), `hide` (Hide) |
| Period Field Draws | `periodUse` | `auto` (Automatic), `alluvial` (Alluvial Over Time), `compare` (Comparison of Two Periods) |
| Show Zero Flows | `showZero` | On / off |
| Finance Mode: Losses for Negative Values (Premium) | `finance` | On / off |

### Nodes (`nodes`)

| Setting | Internal name | Type or options |
| --- | --- | --- |
| Color Nodes By | `colorMode` | `name` (Node Name (Stable)), `level` (Column), `single` (One Color) |
| Node Color | `singleColor` | Colour |
| Color Rule | `rule` | Colour |
| Node Width (0 = Theme) | `width` | Number |
| Node Spacing | `spacing` | Number |
| Corner Radius (-1 = Theme) | `cornerRadius` | Number |
| Order Nodes | `sort` | `smart` (Fewest Crossings), `value` (Largest First), `az` (A to Z), `data` (Data Order), `custom` (Custom (Drag)) |
| Show Top N per Column, 0 = All (Premium) | `topN` | Number |
| Merge Nodes Below % of Column (Premium) | `minNodePct` | Number |
| Other Label | `otherLabel` | Text |
| Drop-Off and Entry Nodes (Premium) | `balance` | On / off |

### Node Colors (`nodeColors`)

| Setting | Internal name | Type or options |
| --- | --- | --- |
| Node Color 1 | `c0` | Colour |
| Node Color 2 | `c1` | Colour |
| Node Color 3 | `c2` | Colour |
| Node Color 4 | `c3` | Colour |
| Node Color 5 | `c4` | Colour |
| Node Color 6 | `c5` | Colour |
| Node Color 7 | `c6` | Colour |
| Node Color 8 | `c7` | Colour |
| Node Color 9 | `c8` | Colour |
| Node Color 10 | `c9` | Colour |
| Node Color 11 | `c10` | Colour |
| Node Color 12 | `c11` | Colour |
| Node Color 13 | `c12` | Colour |
| Node Color 14 | `c13` | Colour |
| Node Color 15 | `c14` | Colour |
| Node Color 16 | `c15` | Colour |
| Node Color 17 | `c16` | Colour |
| Node Color 18 | `c17` | Colour |
| Node Color 19 | `c18` | Colour |
| Node Color 20 | `c19` | Colour |
| Node Color 21 | `c20` | Colour |
| Node Color 22 | `c21` | Colour |
| Node Color 23 | `c22` | Colour |
| Node Color 24 | `c23` | Colour |
| Node Color 25 | `c24` | Colour |
| Node Color 26 | `c25` | Colour |
| Node Color 27 | `c26` | Colour |
| Node Color 28 | `c27` | Colour |
| Node Color 29 | `c28` | Colour |
| Node Color 30 | `c29` | Colour |

### Node Icons (`nodeIcons`)

| Setting | Internal name | Type or options |
| --- | --- | --- |
| Node Icon 1 | `i0` | `none` (None), `factory` (Factory), `bolt` (Lightning), `sun` (Sun), `flame` (Flame), `water` (Water Drop), `leaf` (Leaf), `user` (Person), `users` (People), `cart` (Cart), `store` (Store), `truck` (Truck), `box` (Box), `gear` (Gear), `coin` (Coin), `globe` (Globe), `building` (Building), `heart` (Heart), `star` (Star), `flag` (Flag), `check` (Check) |
| Node Icon 2 | `i1` | `none` (None), `factory` (Factory), `bolt` (Lightning), `sun` (Sun), `flame` (Flame), `water` (Water Drop), `leaf` (Leaf), `user` (Person), `users` (People), `cart` (Cart), `store` (Store), `truck` (Truck), `box` (Box), `gear` (Gear), `coin` (Coin), `globe` (Globe), `building` (Building), `heart` (Heart), `star` (Star), `flag` (Flag), `check` (Check) |
| Node Icon 3 | `i2` | `none` (None), `factory` (Factory), `bolt` (Lightning), `sun` (Sun), `flame` (Flame), `water` (Water Drop), `leaf` (Leaf), `user` (Person), `users` (People), `cart` (Cart), `store` (Store), `truck` (Truck), `box` (Box), `gear` (Gear), `coin` (Coin), `globe` (Globe), `building` (Building), `heart` (Heart), `star` (Star), `flag` (Flag), `check` (Check) |
| Node Icon 4 | `i3` | `none` (None), `factory` (Factory), `bolt` (Lightning), `sun` (Sun), `flame` (Flame), `water` (Water Drop), `leaf` (Leaf), `user` (Person), `users` (People), `cart` (Cart), `store` (Store), `truck` (Truck), `box` (Box), `gear` (Gear), `coin` (Coin), `globe` (Globe), `building` (Building), `heart` (Heart), `star` (Star), `flag` (Flag), `check` (Check) |
| Node Icon 5 | `i4` | `none` (None), `factory` (Factory), `bolt` (Lightning), `sun` (Sun), `flame` (Flame), `water` (Water Drop), `leaf` (Leaf), `user` (Person), `users` (People), `cart` (Cart), `store` (Store), `truck` (Truck), `box` (Box), `gear` (Gear), `coin` (Coin), `globe` (Globe), `building` (Building), `heart` (Heart), `star` (Star), `flag` (Flag), `check` (Check) |
| Node Icon 6 | `i5` | `none` (None), `factory` (Factory), `bolt` (Lightning), `sun` (Sun), `flame` (Flame), `water` (Water Drop), `leaf` (Leaf), `user` (Person), `users` (People), `cart` (Cart), `store` (Store), `truck` (Truck), `box` (Box), `gear` (Gear), `coin` (Coin), `globe` (Globe), `building` (Building), `heart` (Heart), `star` (Star), `flag` (Flag), `check` (Check) |
| Node Icon 7 | `i6` | `none` (None), `factory` (Factory), `bolt` (Lightning), `sun` (Sun), `flame` (Flame), `water` (Water Drop), `leaf` (Leaf), `user` (Person), `users` (People), `cart` (Cart), `store` (Store), `truck` (Truck), `box` (Box), `gear` (Gear), `coin` (Coin), `globe` (Globe), `building` (Building), `heart` (Heart), `star` (Star), `flag` (Flag), `check` (Check) |
| Node Icon 8 | `i7` | `none` (None), `factory` (Factory), `bolt` (Lightning), `sun` (Sun), `flame` (Flame), `water` (Water Drop), `leaf` (Leaf), `user` (Person), `users` (People), `cart` (Cart), `store` (Store), `truck` (Truck), `box` (Box), `gear` (Gear), `coin` (Coin), `globe` (Globe), `building` (Building), `heart` (Heart), `star` (Star), `flag` (Flag), `check` (Check) |
| Node Icon 9 | `i8` | `none` (None), `factory` (Factory), `bolt` (Lightning), `sun` (Sun), `flame` (Flame), `water` (Water Drop), `leaf` (Leaf), `user` (Person), `users` (People), `cart` (Cart), `store` (Store), `truck` (Truck), `box` (Box), `gear` (Gear), `coin` (Coin), `globe` (Globe), `building` (Building), `heart` (Heart), `star` (Star), `flag` (Flag), `check` (Check) |
| Node Icon 10 | `i9` | `none` (None), `factory` (Factory), `bolt` (Lightning), `sun` (Sun), `flame` (Flame), `water` (Water Drop), `leaf` (Leaf), `user` (Person), `users` (People), `cart` (Cart), `store` (Store), `truck` (Truck), `box` (Box), `gear` (Gear), `coin` (Coin), `globe` (Globe), `building` (Building), `heart` (Heart), `star` (Star), `flag` (Flag), `check` (Check) |
| Node Icon 11 | `i10` | `none` (None), `factory` (Factory), `bolt` (Lightning), `sun` (Sun), `flame` (Flame), `water` (Water Drop), `leaf` (Leaf), `user` (Person), `users` (People), `cart` (Cart), `store` (Store), `truck` (Truck), `box` (Box), `gear` (Gear), `coin` (Coin), `globe` (Globe), `building` (Building), `heart` (Heart), `star` (Star), `flag` (Flag), `check` (Check) |
| Node Icon 12 | `i11` | `none` (None), `factory` (Factory), `bolt` (Lightning), `sun` (Sun), `flame` (Flame), `water` (Water Drop), `leaf` (Leaf), `user` (Person), `users` (People), `cart` (Cart), `store` (Store), `truck` (Truck), `box` (Box), `gear` (Gear), `coin` (Coin), `globe` (Globe), `building` (Building), `heart` (Heart), `star` (Star), `flag` (Flag), `check` (Check) |
| Node Icon 13 | `i12` | `none` (None), `factory` (Factory), `bolt` (Lightning), `sun` (Sun), `flame` (Flame), `water` (Water Drop), `leaf` (Leaf), `user` (Person), `users` (People), `cart` (Cart), `store` (Store), `truck` (Truck), `box` (Box), `gear` (Gear), `coin` (Coin), `globe` (Globe), `building` (Building), `heart` (Heart), `star` (Star), `flag` (Flag), `check` (Check) |
| Node Icon 14 | `i13` | `none` (None), `factory` (Factory), `bolt` (Lightning), `sun` (Sun), `flame` (Flame), `water` (Water Drop), `leaf` (Leaf), `user` (Person), `users` (People), `cart` (Cart), `store` (Store), `truck` (Truck), `box` (Box), `gear` (Gear), `coin` (Coin), `globe` (Globe), `building` (Building), `heart` (Heart), `star` (Star), `flag` (Flag), `check` (Check) |
| Node Icon 15 | `i14` | `none` (None), `factory` (Factory), `bolt` (Lightning), `sun` (Sun), `flame` (Flame), `water` (Water Drop), `leaf` (Leaf), `user` (Person), `users` (People), `cart` (Cart), `store` (Store), `truck` (Truck), `box` (Box), `gear` (Gear), `coin` (Coin), `globe` (Globe), `building` (Building), `heart` (Heart), `star` (Star), `flag` (Flag), `check` (Check) |
| Node Icon 16 | `i15` | `none` (None), `factory` (Factory), `bolt` (Lightning), `sun` (Sun), `flame` (Flame), `water` (Water Drop), `leaf` (Leaf), `user` (Person), `users` (People), `cart` (Cart), `store` (Store), `truck` (Truck), `box` (Box), `gear` (Gear), `coin` (Coin), `globe` (Globe), `building` (Building), `heart` (Heart), `star` (Star), `flag` (Flag), `check` (Check) |
| Node Icon 17 | `i16` | `none` (None), `factory` (Factory), `bolt` (Lightning), `sun` (Sun), `flame` (Flame), `water` (Water Drop), `leaf` (Leaf), `user` (Person), `users` (People), `cart` (Cart), `store` (Store), `truck` (Truck), `box` (Box), `gear` (Gear), `coin` (Coin), `globe` (Globe), `building` (Building), `heart` (Heart), `star` (Star), `flag` (Flag), `check` (Check) |
| Node Icon 18 | `i17` | `none` (None), `factory` (Factory), `bolt` (Lightning), `sun` (Sun), `flame` (Flame), `water` (Water Drop), `leaf` (Leaf), `user` (Person), `users` (People), `cart` (Cart), `store` (Store), `truck` (Truck), `box` (Box), `gear` (Gear), `coin` (Coin), `globe` (Globe), `building` (Building), `heart` (Heart), `star` (Star), `flag` (Flag), `check` (Check) |
| Node Icon 19 | `i18` | `none` (None), `factory` (Factory), `bolt` (Lightning), `sun` (Sun), `flame` (Flame), `water` (Water Drop), `leaf` (Leaf), `user` (Person), `users` (People), `cart` (Cart), `store` (Store), `truck` (Truck), `box` (Box), `gear` (Gear), `coin` (Coin), `globe` (Globe), `building` (Building), `heart` (Heart), `star` (Star), `flag` (Flag), `check` (Check) |
| Node Icon 20 | `i19` | `none` (None), `factory` (Factory), `bolt` (Lightning), `sun` (Sun), `flame` (Flame), `water` (Water Drop), `leaf` (Leaf), `user` (Person), `users` (People), `cart` (Cart), `store` (Store), `truck` (Truck), `box` (Box), `gear` (Gear), `coin` (Coin), `globe` (Globe), `building` (Building), `heart` (Heart), `star` (Star), `flag` (Flag), `check` (Check) |
| Node Icon 21 | `i20` | `none` (None), `factory` (Factory), `bolt` (Lightning), `sun` (Sun), `flame` (Flame), `water` (Water Drop), `leaf` (Leaf), `user` (Person), `users` (People), `cart` (Cart), `store` (Store), `truck` (Truck), `box` (Box), `gear` (Gear), `coin` (Coin), `globe` (Globe), `building` (Building), `heart` (Heart), `star` (Star), `flag` (Flag), `check` (Check) |
| Node Icon 22 | `i21` | `none` (None), `factory` (Factory), `bolt` (Lightning), `sun` (Sun), `flame` (Flame), `water` (Water Drop), `leaf` (Leaf), `user` (Person), `users` (People), `cart` (Cart), `store` (Store), `truck` (Truck), `box` (Box), `gear` (Gear), `coin` (Coin), `globe` (Globe), `building` (Building), `heart` (Heart), `star` (Star), `flag` (Flag), `check` (Check) |
| Node Icon 23 | `i22` | `none` (None), `factory` (Factory), `bolt` (Lightning), `sun` (Sun), `flame` (Flame), `water` (Water Drop), `leaf` (Leaf), `user` (Person), `users` (People), `cart` (Cart), `store` (Store), `truck` (Truck), `box` (Box), `gear` (Gear), `coin` (Coin), `globe` (Globe), `building` (Building), `heart` (Heart), `star` (Star), `flag` (Flag), `check` (Check) |
| Node Icon 24 | `i23` | `none` (None), `factory` (Factory), `bolt` (Lightning), `sun` (Sun), `flame` (Flame), `water` (Water Drop), `leaf` (Leaf), `user` (Person), `users` (People), `cart` (Cart), `store` (Store), `truck` (Truck), `box` (Box), `gear` (Gear), `coin` (Coin), `globe` (Globe), `building` (Building), `heart` (Heart), `star` (Star), `flag` (Flag), `check` (Check) |
| Node Icon 25 | `i24` | `none` (None), `factory` (Factory), `bolt` (Lightning), `sun` (Sun), `flame` (Flame), `water` (Water Drop), `leaf` (Leaf), `user` (Person), `users` (People), `cart` (Cart), `store` (Store), `truck` (Truck), `box` (Box), `gear` (Gear), `coin` (Coin), `globe` (Globe), `building` (Building), `heart` (Heart), `star` (Star), `flag` (Flag), `check` (Check) |
| Node Icon 26 | `i25` | `none` (None), `factory` (Factory), `bolt` (Lightning), `sun` (Sun), `flame` (Flame), `water` (Water Drop), `leaf` (Leaf), `user` (Person), `users` (People), `cart` (Cart), `store` (Store), `truck` (Truck), `box` (Box), `gear` (Gear), `coin` (Coin), `globe` (Globe), `building` (Building), `heart` (Heart), `star` (Star), `flag` (Flag), `check` (Check) |
| Node Icon 27 | `i26` | `none` (None), `factory` (Factory), `bolt` (Lightning), `sun` (Sun), `flame` (Flame), `water` (Water Drop), `leaf` (Leaf), `user` (Person), `users` (People), `cart` (Cart), `store` (Store), `truck` (Truck), `box` (Box), `gear` (Gear), `coin` (Coin), `globe` (Globe), `building` (Building), `heart` (Heart), `star` (Star), `flag` (Flag), `check` (Check) |
| Node Icon 28 | `i27` | `none` (None), `factory` (Factory), `bolt` (Lightning), `sun` (Sun), `flame` (Flame), `water` (Water Drop), `leaf` (Leaf), `user` (Person), `users` (People), `cart` (Cart), `store` (Store), `truck` (Truck), `box` (Box), `gear` (Gear), `coin` (Coin), `globe` (Globe), `building` (Building), `heart` (Heart), `star` (Star), `flag` (Flag), `check` (Check) |
| Node Icon 29 | `i28` | `none` (None), `factory` (Factory), `bolt` (Lightning), `sun` (Sun), `flame` (Flame), `water` (Water Drop), `leaf` (Leaf), `user` (Person), `users` (People), `cart` (Cart), `store` (Store), `truck` (Truck), `box` (Box), `gear` (Gear), `coin` (Coin), `globe` (Globe), `building` (Building), `heart` (Heart), `star` (Star), `flag` (Flag), `check` (Check) |
| Node Icon 30 | `i29` | `none` (None), `factory` (Factory), `bolt` (Lightning), `sun` (Sun), `flame` (Flame), `water` (Water Drop), `leaf` (Leaf), `user` (Person), `users` (People), `cart` (Cart), `store` (Store), `truck` (Truck), `box` (Box), `gear` (Gear), `coin` (Coin), `globe` (Globe), `building` (Building), `heart` (Heart), `star` (Star), `flag` (Flag), `check` (Check) |

### Annotations (`annotations`)

| Setting | Internal name | Type or options |
| --- | --- | --- |
| Note 1 | `a0` | Text |
| Note 2 | `a1` | Text |
| Note 3 | `a2` | Text |
| Note 4 | `a3` | Text |
| Note 5 | `a4` | Text |
| Note 6 | `a5` | Text |
| Note 7 | `a6` | Text |
| Note 8 | `a7` | Text |
| Note 9 | `a8` | Text |
| Note 10 | `a9` | Text |
| Note 11 | `a10` | Text |
| Note 12 | `a11` | Text |
| Note 13 | `a12` | Text |
| Note 14 | `a13` | Text |
| Note 15 | `a14` | Text |
| Note 16 | `a15` | Text |
| Note 17 | `a16` | Text |
| Note 18 | `a17` | Text |
| Note 19 | `a18` | Text |
| Note 20 | `a19` | Text |
| Note 21 | `a20` | Text |
| Note 22 | `a21` | Text |
| Note 23 | `a22` | Text |
| Note 24 | `a23` | Text |
| Note 25 | `a24` | Text |
| Note 26 | `a25` | Text |
| Note 27 | `a26` | Text |
| Note 28 | `a27` | Text |
| Note 29 | `a28` | Text |
| Note 30 | `a29` | Text |

### Links (`links`)

| Setting | Internal name | Type or options |
| --- | --- | --- |
| Color Links By | `colorMode` | `theme` (Theme Default), `gradient` (Gradient), `source` (Source Node), `target` (Destination Node), `single` (One Color), `change` (Change (Compare)) |
| Link Color | `singleColor` | Colour |
| Color Rule | `rule` | Colour |
| Opacity % (-1 = Theme) | `opacity` | Number |
| Curvature % (-1 = Theme) | `curvature` | Number |
| Arrowheads | `arrows` | On / off |
| Stayed Flows (Before and After) | `stayed` | `normal` (Normal), `muted` (Muted), `hide` (Hidden) |

### Node Labels (`nodeLabels`)

| Setting | Internal name | Type or options |
| --- | --- | --- |
| Show | `show` | On / off |
| Name | `name` | On / off |
| Value | `value` | On / off |
| Percentage | `percent` | On / off |
| Percentage Of | `percentBasis` | `total` (Total), `level` (Column), `source` (Largest Source), `incoming` (Inflow vs Size) |
| Font | `fontFamily` | `inter` (Inter), `segoe` (Segoe UI), `arial` (Arial), `georgia` (Georgia) |
| Text Size | `fontSize` | Number |
| Bold | `bold` | On / off |
| Italic | `italic` | On / off |
| Underline | `underline` | On / off |
| Name Color | `color` | Colour |
| Value Color | `valueColor` | Colour |
| Display Units | `units` | `auto` (Auto), `none` (None), `K` (Thousands), `M` (Millions), `B` (Billions) |
| Decimals (-1 = Auto) | `decimals` | Number |

### Link Labels (`linkLabels`)

| Setting | Internal name | Type or options |
| --- | --- | --- |
| Show | `show` | On / off |
| Value | `value` | On / off |
| Percentage of Source | `percent` | On / off |

### Column Headers (`headers`)

| Setting | Internal name | Type or options |
| --- | --- | --- |
| Show | `show` | On / off |
| Font | `fontFamily` | `inter` (Inter), `segoe` (Segoe UI), `arial` (Arial), `georgia` (Georgia) |
| Text Size | `fontSize` | Number |
| Bold | `bold` | On / off |
| Italic | `italic` | On / off |
| Underline | `underline` | On / off |
| Color | `color` | Colour |
| Column 1 Header | `h0` | Text |
| Column 2 Header | `h1` | Text |
| Column 3 Header | `h2` | Text |
| Column 4 Header | `h3` | Text |
| Column 5 Header | `h4` | Text |
| Column 6 Header | `h5` | Text |
| Column 7 Header | `h6` | Text |
| Column 8 Header | `h7` | Text |
| Column 9 Header | `h8` | Text |
| Column 10 Header | `h9` | Text |

### Compare (Premium) (`compare`)

| Setting | Internal name | Type or options |
| --- | --- | --- |
| Compare | `enabled` | On / off |
| Current Period (Empty = Latest) | `currentPeriod` | Text |
| Compare With Period (Empty = Previous) | `comparisonPeriod` | Text |
| Count as Unchanged Below % | `flatBand` | Number |
| Biggest Changes Strip | `strip` | On / off |
| Show Lost Flows (Dashed) | `showLost` | On / off |

### Small Multiples (Premium) (`smallMultiples`)

| Setting | Internal name | Type or options |
| --- | --- | --- |
| Columns (0 = Auto) | `columns` | Number |
| Same Scale in Every Panel | `sharedScale` | On / off |

### Insights (Premium) (`insights`)

| Setting | Internal name | Type or options |
| --- | --- | --- |
| Show Insights | `show` | On / off |
| Number of Sentences | `count` | Number |

### Interaction (`interaction`)

| Setting | Internal name | Type or options |
| --- | --- | --- |
| Trace Paths on Hover and Click | `trace` | On / off |
| Dimmed Opacity % | `dim` | Number |
| Drag Nodes | `drag` | On / off |
| Reset Dragged Positions | `resetLayout` | On / off |
| Data Table Button | `tableButton` | On / off |
| Double-Click Collapses Downstream (Premium) | `expand` | On / off |
| Trace Exact Volume Shares in Journeys (Premium) | `volumeTrace` | On / off |
| Export Button (Premium) | `exportButton` | On / off |
| Export Format | `exportFormat` | `xlsx` (Excel Workbook), `csv` (CSV) |

### Theme (`theme`)

| Setting | Internal name | Type or options |
| --- | --- | --- |
| Theme | `selectedTheme` | `smartvisuals` (SmartVisuals), `dark` (Dark), `clean` (Clean (White)), `slate` (Slate) |
| Use Report Theme Colors | `reportColors` | On / off |
| Transparent Background | `transparentBg` | On / off |
| Background Color | `bgColor` | Colour |

### Accessibility (`accessibility`)

| Setting | Internal name | Type or options |
| --- | --- | --- |
| Focus Outline Color | `focusColor` | Colour |
| Focus Outline Width | `focusWidth` | Number |
| Minimum Text Size | `minFontSize` | Number |
| Reduce Motion | `reduceMotion` | On / off |
| Patterns for States (Non-Color Cue) | `patterns` | On / off |

### Style Template (`styleTemplate`)

| Setting | Internal name | Type or options |
| --- | --- | --- |
| This Visual's Style Code (Copy) | `copy` | Text |
| Paste a Style Code to Apply | `paste` | Text |

### State (`state`)

| Setting | Internal name | Type or options |
| --- | --- | --- |
| Positions | `positions` | Text |
| Order | `order` | Text |
| Color Memory | `colorMemory` | Text |
| Color Keys | `colorKeys` | Text |
