# SmartVisuals Stream & Ribbon for Power BI

> Stream graph (streamgraph) and ribbon chart for Power BI: every period ranked, ties by a stated rule, names inside the bands. Free; Premium adds what changed.

- Page: https://www.smartvisuals.io/visuals/stream-ribbon
- Fields and settings: https://www.smartvisuals.io/visuals/stream-ribbon/settings
- Microsoft Marketplace: https://marketplace.microsoft.com/en-us/product/smartvisuals.smartvisuals-stream-ribbon?tab=overview
- Package: https://www.smartvisuals.io/downloads/smartvisuals-stream-ribbon-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): `smartvisualsStreamRibbonA8CA12EE1E495D3CBD2D13C9AE580AE3`

## What is free

- **Ribbon chart**: Each period re-sorted by rank, largest on top or at the bottom, segment spacing, ribbon opacity, smooth or straight ribbons and ribbon borders.
- **Stream graph**: Wiggle, silhouette, 100 % and stacked layouts, inside-out, largest-on-top, peak date, name or data order, and a size scale where an axis would mislead.
- **Ranks with a stated tie rule**: Equal values share the rank and keep the previous period's order, then name; the footnote can state the rule.
- **Names inside the bands**: Name, value, share or rank inside each band, sized by thickness and never overlapping, plus start and end labels.
- **Legend in rank order**: Ordered by last-period rank, total, name or data order, with a button that lets readers change the order.
- **Events and reference lines**: Annotations from a field or typed in the pane, shaded until the next event, horizontal and vertical reference lines.
- **Total and trend**: A total line with a linear trend and total labels above the bands.
- **Zoom and range navigator**: Ctrl + wheel zooms, dragging pans, and a range navigator under the chart; periods spaced equally or by date.
- **Shapes and orientation**: Vertical or horizontal; smooth, straight or step edges with a curvature slider; flat or gradient fills.
- **Colours your way**: Power BI fx rules, Focus Colours to emphasise named series and grey the rest, colours by legend order or by name, or the report theme's palette.
- **Templates and four themes**: Executive, IBCS, Minimal, Presentation and Print; SmartVisuals, Dark, Clean and Slate; animated data changes and a reveal animation.
- **Accessibility and 20 languages**: Keyboard navigation, a screen reader summary, a data table with ranks, hatch patterns, high contrast and 20 languages.

## What premium adds

- **Rank change**: ▲ and ▼ rank changes and Δ or Δ % against the previous period, the same period last year or a Comparison field, with the old rank as a ghost.
- **Top N and Other per period**: Each period keeps its own top N, the rest in one Other band, with entries and exits marked.
- **Rank by a second measure**: The thickness stays revenue while the order follows margin or growth.
- **Risers and overtakes**: The biggest riser and faller highlighted, overtakes marked, and a one-line callout naming the most important one.
- **Playback**: Step through the periods with a play button or P, and watch the ranking re-sort live.
- **Small multiples**: One chart per region or business unit, on a shared scale by default.
- **Forecast of the total**: Exponential smoothing on the total with 80 % and 95 % prediction intervals.

## Fields

| Field | Internal name | Takes | Needed | What it is for |
| --- | --- | --- | --- | --- |
| Axis (period) | `axis` | Column | Optional | A date, a date hierarchy level, a number or text periods: one rank per period |
| Legend | `legend` | Column | Optional | The categories to rank (one band per value) |
| Values | `values` | Measure | Optional | The measure that sets the thickness of every band |
| Rank by (premium) | `rankBy` | Measure | Optional | A second measure that sets the order, e.g. margin or growth |
| Comparison | `comparison` | Measure | Optional | Previous year, plan or any reference value per category |
| Small multiples | `facet` | Column | Optional | One panel per value (premium) |
| Annotation | `annotation` | Measure | Optional | Text measure: a non-blank value pins a note on that period |
| Tooltips | `tooltips` | Measure | Optional | Extra fields in tooltips |

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

### Chart (`view`)

| Setting | Internal name | Type or options |
| --- | --- | --- |
| Chart Type | `type` | `stream` (Stream graph (streamgraph)), `ribbon` (Ribbon chart) |
| Orientation | `orientation` | `vertical` (Time from left to right), `horizontal` (Time from top to bottom) |
| Period Spacing | `spacing` | `equal` (Equal), `date` (By date) |

### Style Template (`template`)

| Setting | Internal name | Type or options |
| --- | --- | --- |
| Template | `preset` | `none` (Default), `executive` (Executive), `ibcs` (IBCS), `minimal` (Minimal), `presentation` (Presentation), `print` (Print), `custom` (Custom) |
| Applied | `applied` | Text |

### Stream (`stream`)

| Setting | Internal name | Type or options |
| --- | --- | --- |
| Layout (Offset) | `offset` | `wiggle` (Wiggle (streamgraph)), `silhouette` (Silhouette (centred)), `expand` (100 % (expand)), `zero` (Stacked from zero) |
| Stack Order | `order` | `insideOut` (Inside-out (largest in the middle)), `ascending` (Largest on top), `descending` (Largest at the bottom), `peak` (By peak date), `data` (Data order), `name` (Name) |
| Edges | `curve` | `smooth` (Smooth), `straight` (Straight), `step` (Steps) |
| Curvature (%) | `curvature` | Number |
| Fill | `fill` | `theme` (From theme), `flat` (Flat), `gradient` (Gradient) |
| Fill Opacity (%, 0 = theme) | `opacity` | Number |
| Outline Between Streams | `outline` | On / off |

### Ribbon (`ribbon`)

| Setting | Internal name | Type or options |
| --- | --- | --- |
| Largest Value | `largest` | `top` (On top), `bottom` (At the bottom) |
| Column Width (%) | `columnWidth` | Number |
| Spacing Between Segments (px) | `gap` | Number |
| Ribbon Opacity (%) | `ribbonOpacity` | Number |
| Ribbon Shape | `curve` | `smooth` (Smooth), `straight` (Straight) |
| Curvature (%) | `curvature` | Number |
| Ribbon Border | `border` | On / off |
| Corner Radius (-1 = theme) | `cornerRadius` | Number |

### Ranking (`ranking`)

| Setting | Internal name | Type or options |
| --- | --- | --- |
| Tie Rule | `ties` | `previous` (Keep the previous period's order, then name), `name` (Name (A to Z)) |
| Legend Order | `legendOrder` | `rank` (Rank in the last period), `total` (Total over all periods), `data` (Data order), `name` (Name) |
| Let Readers Change the Order | `readerSort` | On / off |
| Order Button Text Size | `buttonSize` | Number |

### Labels Inside Bands (`labels`)

| Setting | Internal name | Type or options |
| --- | --- | --- |
| Show | `show` | On / off |
| Content | `content` | `name` (Name), `nameValue` (Name and value), `nameShare` (Name and share), `nameRank` (Rank and name), `value` (Value), `share` (Share), `rank` (Rank) |
| Font Size | `fontSize` | Number |
| Colour (empty = automatic contrast) | `color` | Colour |
| In Every Column | `everyPeriod` | On / off |
| Decimals (-1 = auto) | `decimals` | Number |

### Start Labels (`startLabels`)

| Setting | Internal name | Type or options |
| --- | --- | --- |
| Show | `show` | On / off |
| Content | `content` | `name` (Name), `nameValue` (Name and value), `nameShare` (Name and share), `nameRank` (Rank and name), `value` (Value), `share` (Share), `rank` (Rank) |
| Font Size | `fontSize` | Number |
| Colour | `color` | Colour |

### End Labels (`endLabels`)

| Setting | Internal name | Type or options |
| --- | --- | --- |
| Show | `show` | On / off |
| Content | `content` | `name` (Name), `nameValue` (Name and value), `nameShare` (Name and share), `nameRank` (Rank and name), `value` (Value), `share` (Share), `rank` (Rank) |
| Font Size | `fontSize` | Number |
| Colour | `color` | Colour |

### Focus Colours (`focus`)

| Setting | Internal name | Type or options |
| --- | --- | --- |
| Series to Emphasise (comma-separated names) | `names` | Text |
| Grey Out the Rest | `greyRest` | On / off |

### Data Point Markers (`markers`)

| Setting | Internal name | Type or options |
| --- | --- | --- |
| Show | `show` | On / off |
| Size | `size` | Number |

### Tooltip (`tooltip`)

| Setting | Internal name | Type or options |
| --- | --- | --- |
| Share of the Period | `share` | On / off |
| Rank (with ties) | `rank` | On / off |
| Period Total | `total` | On / off |

### Compare (What Changed) (`compare`)

| Setting | Internal name | Type or options |
| --- | --- | --- |
| Compare With | `base` | `none` (Nothing), `previous` (The previous period), `year` (Same period last year (from the data)), `field` (The Comparison field) |
| Rank Change ▲ ▼ in Labels | `rankChange` | On / off |
| Change in Labels and Tooltips | `delta` | `off` (Off), `abs` (Absolute (Δ)), `pct` (Relative (Δ %)), `both` (Both) |
| Show the Reference Rank as a Ghost | `ghost` | On / off |

### Top N and Other (`topN`)

| Setting | Internal name | Type or options |
| --- | --- | --- |
| Top N per Period (0 = all) | `n` | Number |
| The Rest | `others` | `band` (One "Other" band), `hide` (Hide) |
| Name of the Other Band | `othersLabel` | Text |
| Mark Entries and Exits | `marks` | On / off |

### Risers and Overtakes (`insights`)

| Setting | Internal name | Type or options |
| --- | --- | --- |
| Highlight the Biggest Riser and Faller | `movers` | On / off |
| Mark Overtakes | `overtakes` | On / off |
| Only Overtakes Into the Top (0 = any) | `within` | Number |
| Callout Sentence | `callout` | On / off |

### Forecast of the Total (`forecast`)

| Setting | Internal name | Type or options |
| --- | --- | --- |
| Show | `show` | On / off |
| Periods Ahead (0 = automatic) | `horizon` | Number |
| Prediction Interval | `interval` | `none` (None), `80` (80 %), `95` (95 %), `both` (80 % and 95 %) |

### X-Axis (`xAxis`)

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

### Y-Axis (`yAxis`)

| Setting | Internal name | Type or options |
| --- | --- | --- |
| Show | `show` | On / off |
| Title | `showTitle` | On / off |
| Maximum (blank = auto) | `max` | Text |
| Decimals (-1 = auto) | `decimals` | Number |
| Font Size | `fontSize` | Number |
| Colour | `color` | Colour |

### Gridlines (`gridlines`)

| Setting | Internal name | Type or options |
| --- | --- | --- |
| Style | `style` | `theme` (From theme), `solid` (Solid), `dashed` (Dashed), `dotted` (Dotted), `none` (None) |
| Colour | `color` | Colour |

### Legend (`legend`)

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

### Total and Trend (`totalLine`)

| Setting | Internal name | Type or options |
| --- | --- | --- |
| Total Line | `show` | On / off |
| Trend Line of the Total | `trend` | `none` (None), `linear` (Linear) |
| Total Labels | `labels` | On / off |
| Total Label Size | `labelSize` | Number |
| Colour | `color` | Colour |

### Reference Lines (`refLines`)

| Setting | Internal name | Type or options |
| --- | --- | --- |
| Horizontal Line | `line` | `none` (None), `value` (A value), `average` (Average total) |
| Value | `value` | Number |
| Label | `label` | Text |
| Vertical Line at Period | `period` | Text |
| Vertical Line Label | `periodLabel` | Text |
| Colour | `color` | Colour |
| Show Line Labels | `showLabels` | On / off |
| Label Size | `fontSize` | Number |

### Annotations (`annotations`)

| Setting | Internal name | Type or options |
| --- | --- | --- |
| Events (period: text; period: text) | `list` | Text |
| Shade Until the Next Annotation | `shade` | On / off |
| Style | `style` | `pin` (Pin with label), `flag` (Flag on the axis) |
| Show Notes | `showNotes` | On / off |
| Font Size | `fontSize` | Number |
| Colour | `color` | Colour |

### Zoom (`zoom`)

| Setting | Internal name | Type or options |
| --- | --- | --- |
| Ctrl + Wheel Zooms, Drag Pans | `wheel` | On / off |
| Range Navigator | `navigator` | On / off |
| Navigator Height | `navHeight` | Number |

### Playback (`playback`)

| Setting | Internal name | Type or options |
| --- | --- | --- |
| Play Through the Periods | `show` | On / off |
| Milliseconds per Period | `speed` | Number |
| Show the Playing Period | `showPeriod` | On / off |
| Period Text Size | `periodSize` | Number |
| Period Text Colour | `periodColor` | Colour |
| Button Text Size | `buttonSize` | Number |

### Small Multiples (`smallMultiples`)

| Setting | Internal name | Type or options |
| --- | --- | --- |
| Columns (0 = auto) | `columns` | Number |
| Shared Scale | `sharedScale` | On / off |
| Panel Titles | `showTitles` | On / off |
| Title Size | `titleSize` | Number |
| Title Colour | `titleColor` | Colour |

### Smart Caption (`caption`)

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

### Footnote (`footnote`)

| Setting | Internal name | Type or options |
| --- | --- | --- |
| Show | `show` | On / off |
| Source | `source` | Text |
| State the Rank and Tie Rule | `rule` | On / off |
| Font Size | `fontSize` | Number |
| Colour | `color` | Colour |

### Accessibility (`accessibility`)

| Setting | Internal name | Type or options |
| --- | --- | --- |
| Distinguish Series Without Colour | `distinguish` | On / off |
| Focus Outline Colour | `focusColor` | Colour |
| Focus Outline Width | `focusWidth` | Number |
| Minimum Text Size (0 = off) | `minFontSize` | Number |
| Data Table Text Size | `tableSize` | 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 |
| Colours | `palette` | `theme` (From the visual theme), `report` (From the report theme) |
| Colour Order | `colorBy` | `order` (Legend order), `name` (Name (stable when filtered)) |
| Reveal Animation | `reveal` | On / off |
| Animate Data Changes | `morph` | On / off |

### Series Colours (`seriesColors`)

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

### Data Colours (`dataPoint`)

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