# SmartVisuals Newspaper for Power BI

> Power BI visual that writes a newspaper front page from your data: headlines, stories, charts and a numbers table. Offline, in four headline languages.

- Page: https://www.smartvisuals.io/visuals/newspaper
- Fields and settings: https://www.smartvisuals.io/visuals/newspaper/settings
- Microsoft Marketplace: https://marketplace.microsoft.com/en-us/product/smartvisuals.smartvisuals-newspaper?tab=overview
- Package: https://www.smartvisuals.io/downloads/smartvisuals-newspaper-1.0.0.0.pbiviz
- Sample report (zipped .pbip): https://www.smartvisuals.io/samples/smartvisuals-newspaper-sample-1.0.0.0.zip
- Price: Free tier for every viewer; premium $2.99 per user per month or $29 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): `smartvisualsNewspaper5E1A7C93D0B24F6A8E21C4D7B9F03A61`

## What is free

- **The front page**: Lead change, leader and lead margin, biggest rise and fall, total and the share of the top three, ranked into a lead, columns, In brief and The Numbers.
- **Headlines in four languages**: Headlines in English, Spanish, Portuguese and German, picked from the report language or set in Stories > Headline Language; the format pane comes in 20 languages.
- **Measures read the right way round**: Lower is better for costs, a measure type for averages and percentages, Leave Out for categories such as a test branch, fx bar colours and dynamic format strings.
- **Layouts that fit the tile**: Broadsheet, tabloid and digest, picked by tile size, and Boardroom mode with bars, a trend chart and plain bullet points.
- **Your paper**: Four themes (SmartVisuals, Dark, Clean and Slate) and your own masthead title and tagline with tokens such as {period} and {measure}.
- **Tooltips, cross-filter, keyboard**: Hover a story for its numbers and "How this was written"; click or press Enter to cross-filter by its category; cross-highlight, context menu and high contrast.

## What premium adds

- **Records, streaks, comebacks and unusual moves**: A record needs six periods of history, a streak three; an unusual move prints the usual range it broke.
- **Plan, last year and year to date**: Plan stories from a Target, last year next to last month, and year to date against plan and last year.
- **Editions**: Edition By prints one front page per business unit or country, with a pager.
- **More measures, your own headlines, a pinned lead**: Stories on up to two more measures, headline templates per story type, lead headline and deck templates, and a category pinned to the lead.
- **Special editions**: Vintage (letterpress) and Evening Edition (the late final) papers for the newspaper style.

## Fields

| Field | Internal name | Takes | Needed | What it is for |
| --- | --- | --- | --- | --- |
| Category | `category` | Column | Optional | Who the stories are about: branch, region, product, team. |
| Period | `period` | Column | Optional | When: month, quarter, year or a date. Enables movers, records and streaks. |
| Edition By ★ | `editionBy` | Column | Optional | One front page per value, for example per business unit or country (premium). |
| Measure | `measure` | Measure | Optional | The lead measure the front page reports on. |
| More Measures ★ | `secondary` | Measure | Optional, up to 2 | Up to two more measures for Editor's desk stories (premium). |
| Target ★ | `target` | Measure | Optional | Plan, budget or target for the lead measure: stories against plan (premium). |
| Image | `image` | Column | Optional | A logo or photo per category as a data: URI. Web addresses are never fetched. |
| Tooltips | `tooltips` | Measure | Optional, up to 5 | Extra values shown when hovering a story. |

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

### Masthead (`masthead`)

| Setting | Internal name | Type or options |
| --- | --- | --- |
| Show Masthead | `show` | On / off |
| Title | `title` | Text |
| Tagline | `tagline` | Text |
| Show Edition Line | `showEditionLine` | On / off |
| Title Size (0 = Auto) | `titleSize` | Number |

### Edition (`edition`)

| Setting | Internal name | Type or options |
| --- | --- | --- |
| Style | `style` | `newspaper` (Newspaper), `boardroom` (Boardroom) |
| Layout | `layout` | `auto` (Auto (Fit the Tile)), `broadsheet` (Broadsheet), `tabloid` (Tabloid), `digest` (Digest) |
| Stories Below the Lead | `storyCount` | Number |
| Show In Brief | `showBriefs` | On / off |
| Show The Numbers | `showNumbers` | On / off |
| Edition Period | `editionPeriod` | `auto` (Auto (Skip a Half-Loaded Period)), `latest` (Latest), `previous` (Previous) |
| Compare With | `comparison` | `previous` (Previous Period), `both` (Previous Period and Last Year ★) |

### Editions ★ (`editions`)

| Setting | Internal name | Type or options |
| --- | --- | --- |
| Open on Edition ★ | `start` | Text |

### Stories (`stories`)

| Setting | Internal name | Type or options |
| --- | --- | --- |
| Headline Language | `language` | `auto` (Auto (Report Language)), `en` (English), `es` (Español), `pt` (Português), `de` (Deutsch) |
| Headline Case | `headlineCase` | `sentence` (Sentence case), `title` (Title Case), `upper` (UPPERCASE) |
| Smallest Change Worth Reporting (%) | `minChange` | Number |
| Which Way Is Better | `polarity` | `auto` (Auto (From the Measure Name)), `higher` (Higher Is Better), `lower` (Lower Is Better), `neutral` (Neither Is Better) |
| Measure Type | `measureType` | `auto` (Auto (From Format and Name)), `amount` (Amount (Adds Up)), `average` (Average or Ratio), `percent` (Percentage (Changes in Points)) |
| Rank Changes | `showOvertake` | On / off |
| Biggest Rise and Fall | `showMovers` | On / off |
| Total | `showTotal` | On / off |
| Leader and Lead Margin | `showLeader` | On / off |
| Share of the Top Three | `showConcentration` | On / off |
| Leave Out (Comma-Separated) | `muteCategories` | Text |

### Charts (`charts`)

| Setting | Internal name | Type or options |
| --- | --- | --- |
| Show Charts | `show` | On / off |
| Story Color (Empty = Theme) | `accentColor` | Colour |
| Rise Color (Empty = Theme) | `upColor` | Colour |
| Fall Color (Empty = Theme) | `downColor` | Colour |
| Bar Color (fx) | `barColor` | Colour |

### Images (`images`)

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

### Typography (`typography`)

| Setting | Internal name | Type or options |
| --- | --- | --- |
| Headline Font | `headlineFont` | `theme` (Theme), `serif` (Serif), `sans` (Sans), `condensed` (Condensed) |
| Body Font | `bodyFont` | `theme` (Theme), `serif` (Serif), `sans` (Sans) |
| Body Text Size | `bodySize` | Number |
| Headline Scale (%) | `headlineScale` | Number |

### Editor's Desk ★ (`editorsDesk`)

| Setting | Internal name | Type or options |
| --- | --- | --- |
| Records ★ | `recordStories` | On / off |
| Streaks and Comebacks ★ | `streakStories` | On / off |
| Unusual Moves ★ | `unusualStories` | On / off |
| Plan Stories ★ | `targetStories` | On / off |
| Stories on More Measures ★ | `secondaryStories` | On / off |
| Year-to-Date Story ★ | `ytdStory` | On / off |
| Lead Headline Template ★ | `leadTemplate` | Text |
| Lead Deck Template ★ | `deckTemplate` | Text |
| Pin to the Lead ★ | `pinCategory` | Text |

### Headline Templates ★ (`headlineTemplates`)

| Setting | Internal name | Type or options |
| --- | --- | --- |
| Lead Change ★ | `overtakeLead` | Text |
| Rank Change ★ | `overtake` | Text |
| Record ★ | `record` | Text |
| Biggest Rise ★ | `surge` | Text |
| Biggest Fall ★ | `slump` | Text |
| Comeback ★ | `comeback` | Text |
| Streak ★ | `streak` | Text |
| Unusual Move ★ | `unusual` | Text |
| Total ★ | `total` | Text |
| Leader ★ | `leader` | Text |
| Lead Margin ★ | `gap` | Text |
| Share of the Top Three ★ | `concentration` | Text |
| Plan ★ | `target` | Text |
| Year to Date ★ | `ytd` | Text |

### Accessibility (`accessibility`)

| Setting | Internal name | Type or options |
| --- | --- | --- |
| Focus Outline Color (Empty = Theme) | `focusColor` | Colour |
| Focus Outline Width | `focusWidth` | Number |
| Minimum Text Size | `minTextSize` | Number |
| Reduce Motion | `reduceMotion` | On / off |
| Arrows for Rise and Fall | `nonColorCues` | On / off |

### Theme (`theme`)

| Setting | Internal name | Type or options |
| --- | --- | --- |
| Theme | `selectedTheme` | `smartvisuals` (SmartVisuals), `dark` (Dark), `clean` (Clean (White)), `slate` (Slate) |
| Special Edition | `specialEdition` | `none` (None), `vintage` (Vintage ★), `pink` (Evening Edition ★) |
| Paper Color (Empty = Theme) | `bgColor` | Colour |
| Transparent Background | `transparentBg` | On / off |