# SmartVisuals News Ticker for Power BI

> SmartVisuals News Ticker: a free broadcast-style scrolling strip of headlines, KPIs and alerts fed straight from your data model. Badges, up/down deltas, cross-filtering, keyboard access — no license, no watermark.

- Page: https://www.smartvisuals.io/visuals/news-ticker
- Fields and settings: https://www.smartvisuals.io/visuals/news-ticker/settings
- Microsoft Marketplace: https://marketplace.microsoft.com/en-us/product/smartvisuals.smartvisuals-news-ticker?tab=overview
- Package: https://www.smartvisuals.io/downloads/smartvisuals-news-ticker-1.0.2.0.pbiviz
- Sample data (CSV): https://www.smartvisuals.io/samples/smartvisuals-news-ticker-sample-data.zip
- Price: Free, every feature, no licence.
- Certified by Microsoft: yes
- Version: 1.0.2.0
- GUID (visualType and publicCustomVisuals): `newsTickerFF0C7FA832F7423BBE12BC98F71ADB28`

## What is free

- **Broadcast strip or news-flash stack**: Horizontal marquee or vertical mode, with 1–5 scrolling rows and per-row lanes.
- **Badges, values and deltas**: Short category chips (BREAKING, OPS, SALES…) auto-colored per badge and labeled with your real badge names, values honoring the measure's format string, and ▲/▼ change arrows — invertible for metrics where down is good.
- **A flash when numbers move**: Items flash when their values change, and per-item images (offline data URIs) put a logo next to each headline.
- **Viewer-friendly by design**: Pause button, report-highlight dimming, edge fade, reduced-motion support (static strip), high contrast, and a static mode for clean exports.
- **Full keyboard access**: One tab stop for the whole ticker: arrow keys move between items, Home/End jump to the ends, Enter cross-filters, Escape clears. Focus holds the strip still.

## Fields

| Field | Internal name | Takes | Needed | What it is for |
| --- | --- | --- | --- | --- |
| Headline | `headline` | Column | Optional | The text of each ticker item |
| Badge | `badge` | Column | Optional | Short category label shown as a colored chip (e.g. BREAKING, OPS, SALES) |
| Image | `image` | Column | Optional | Optional logo or icon per item. Base64 data URIs only (data:image/...) — external URLs are not loaded, so the visual stays offline and certifiable. |
| Value | `value` | Measure | Optional | Number shown after the headline (stock-ticker style) |
| Change | `change` | Measure | Optional | Delta that drives the up/down arrow and coloring |

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

### Theme (`theme`)

| Setting | Internal name | Type or options |
| --- | --- | --- |
| Theme | `selectedTheme` | `smartvisuals` (SmartVisuals), `dark` (Dark (Newsroom)), `clean` (Clean (Print)), `slate` (Slate) |
| Background Color (empty = theme) | `bgColor` | Colour |
| Transparent Background | `transparentBg` | On / off |

### Ticker (`ticker`)

| Setting | Internal name | Type or options |
| --- | --- | --- |
| Speed (px/s) | `speed` | Number |
| Scroll Direction | `direction` | `left` (Right to Left), `right` (Left to Right), `up` (Bottom to Top (Vertical)), `down` (Top to Bottom (Vertical)) |
| Rows (Columns When Vertical) | `lanes` | Number |
| Static Mode (Export-Friendly) | `staticMode` | On / off |
| Pause on Hover | `pauseOnHover` | On / off |
| Gap Between Items | `itemGap` | Number |
| Vertical Alignment | `verticalAlign` | `top` (Top), `middle` (Middle), `bottom` (Bottom) |
| Fade at Edges | `edgeFade` | On / off |
| Show Pause Button | `showPauseButton` | On / off |

### Items (`items`)

| Setting | Internal name | Type or options |
| --- | --- | --- |
| Font | `fontFamily` | `inter` (Inter), `segoe` (Segoe UI), `arial` (Arial), `georgia` (Georgia), `mono` (Monospace (Stock)) |
| Font Size | `fontSize` | Number |
| Text Color | `textColor` | Colour |
| Uppercase Headlines | `uppercaseMode` | `auto` (Auto (Theme)), `on` (On), `off` (Off) |
| Separator | `separator` | `auto` (Auto (Theme)), `dot` (Dot •), `pipe` (Pipe \|), `diamond` (Diamond ◆), `dash` (Dash —), `none` (None) |
| Separator Color | `separatorColor` | Colour |

### Badges (`badge`)

| Setting | Internal name | Type or options |
| --- | --- | --- |
| Show Badges | `show` | On / off |
| Style | `chipStyle` | `auto` (Auto (Theme)), `chip` (Colored Chip), `text` (Plain Text) |
| One Color for All Badges | `badgeColor` | Colour |
| Badge Text Color | `badgeTextColor` | Colour |
| Badge 1 | `badgeColor1` | Colour |
| Badge 2 | `badgeColor2` | Colour |
| Badge 3 | `badgeColor3` | Colour |
| Badge 4 | `badgeColor4` | Colour |
| Badge 5 | `badgeColor5` | Colour |
| Badge 6 | `badgeColor6` | Colour |
| Badge 7 | `badgeColor7` | Colour |
| Badge 8 | `badgeColor8` | Colour |

### Values (`values`)

| Setting | Internal name | Type or options |
| --- | --- | --- |
| Show Value | `showValue` | On / off |
| Show Change | `showChange` | On / off |
| Show ▲▼ Arrows | `showArrows` | On / off |
| Positive Color | `positiveColor` | Colour |
| Negative Color | `negativeColor` | Colour |
| Invert (Down Is Good) | `invertColors` | On / off |

### Images (`images`)

| Setting | Internal name | Type or options |
| --- | --- | --- |
| Show Images | `show` | On / off |
| Image Height (px) | `height` | Number |
| Round Images | `rounded` | On / off |

### Data Change Flash (`flash`)

| Setting | Internal name | Type or options |
| --- | --- | --- |
| Flash Changed Items | `show` | On / off |
| Flash Color (empty = brand accent) | `color` | Colour |

### Announcement (`announcement`)

| Setting | Internal name | Type or options |
| --- | --- | --- |
| Announcement Text | `text` | Text |
| Announcement Color (empty = brand accent) | `color` | Colour |