SmartVisuals Research fields and settings

Every field well and every setting in the format pane of version 1.0.1.0, read from the package you download. The internal names in grey are what a PBIR file or a report-authoring agent uses. Which features need a licence is on the SmartVisuals Research page; every setting works in edit mode with or without one.

9 fields · 17 cards · 92 settings Markdown for AI assistants catalog.json

Fields

Field	Takes	Needed	What it is for
Question`question`	Column	Optional	Likert and Crosstab: one row / table block per question. NPS: leave empty or filter to the recommend question
Answer / Score`answer`	Column	Optional	Scale answers in model sort order (use Sort By Column); for the NPS view the 0–10 likelihood-to-recommend score
Value`value`	Measure	Optional	Respondent count — or Sum of Weight for weighted results
Segment / Columns`segment`	Column	Optional	Optional (premium): comparison groups — Likert segments, Crosstab banner columns, NPS segments — with significance letters
Wave / Period`wave`	Column	Optional	Optional: tracker mode — NPS trend over waves; Likert and Crosstab show the latest wave with the change since the previous one
Sum of Weight² (significance)`weightsq`	Measure	Optional	Optional: SUM(weight²) enables effective bases for weighted significance testing
Dimension / Group`group`	Column	Optional	Optional: the section a statement belongs to (Leadership, Tools, …) — drawn as a header with its pooled score
Question Text`questionText`	Column	Optional	Optional: the full wording behind a short question code — shown in tooltips, the caption and the footnote
Benchmark (top box)`benchmark`	Measure	Optional	Optional: a norm or benchmark for each statement's top box, as a fraction (0.62) or percent (62) — the delta shows next to the net

View`viewSettings`

Setting	Type and options
View`view`	Likert battery `likert` Crosstab `crosstab` NPS `nps`
Show View Switcher`showTabs`	On / off

Theme`theme`

Setting	Type and options
Theme`selectedTheme`	SmartVisuals `smartvisuals` Dark `dark` Clean (White) `clean` Slate `slate`
Transparent Background`transparentBg`	On / off
Quick Style`stylePreset`	Custom (keep my settings) `custom` Agency deck `agency` Executive summary `executive` Compact tracker `compact`

Scale`scaleSettings`

Setting	Type and options
Neutral Handling`neutralMode`	Auto (middle of odd scale) `auto` No neutral `none` Custom position `custom`
Neutral Position (1-based)`neutralIndex`	Number
Reverse Scale Order`reverseScale`	On / off
N/A Answer Labels (comma-separated)`naLabels`	Text
Include N/A in Base`naInBase`	On / off
Collapse Scale (disagree / neutral / agree)`collapseScale`	On / off

Colors`colorSettings`

Setting	Type and options
Positive Side`positiveColor`	Colour
Negative Side`negativeColor`	Colour
Neutral`neutralColor`	Colour
N/A`naColor`	Colour
Detractors`detractorColor`	Colour
Passives`passiveColor`	Colour
Promoters`promoterColor`	Colour

Bars`barSettings`

Setting	Type and options
Corner Radius`cornerRadius`	Number
Bar Thickness (%)`thickness`	Number
Gap Between Segments`segmentGap`	Number

Answer Colors`answerColors`

Setting	Type and options
Color`fill`	Colour

Labels`labelSettings`

Setting	Type and options
Show % in Segments`showPct`	On / off
Decimal Places`decimals`	Number
Min Segment % to Label`minSegmentPct`	Number
Font Size`fontSize`	Number
Font`fontFamily`	Inter `inter` Segoe UI `segoe` Arial `arial` Georgia `georgia`
Font Color`fontColor`	Colour
Show Base (n=)`showBase`	On / off
Show Split %`showShares`	On / off

Nets & Means (Premium)`netSettings`

Setting	Type and options
Show Top Box`showTopBox`	On / off
Show Bottom Box`showBottomBox`	On / off
Box Size (scale points)`boxSize`	Number
Show Mean (scale 1..k)`showMean`	On / off
Mean Decimal Places`meanDecimals`	Number
All Statements Row`showTotalRow`	On / off
Benchmark Label`benchmarkLabel`	Text
Show Change vs Previous Wave`showWaveDelta`	On / off
Show Margin of Error (±)`showMarginOfError`	On / off

Sorting`sortSettings`

Setting	Type and options
Sort Questions By`sortBy`	Data order `data` Top box (high → low) `topDesc` Top box (low → high) `topAsc`

Legend`legendSettings`

Setting	Type and options
Show Legend`show`	On / off
Position`position`	Bottom `bottom` Top `top`

Display`display`

Setting	Type and options
Cell Content`cellContent`	Column % `pct` Value `count` % and value `both` Index vs Total `index`
% Decimal Places`decimals`	Number
Show Total Column`showTotal`	On / off
Show Base Row`showBaseRow`	On / off
Shade Cells by %`heatmap`	On / off
Show Headline Score`showHeadline`	On / off
Show Split Bar`showSplit`	On / off
Show Wave Trend`showTrend`	On / off
Score Decimal Places`scoreDecimals`	Number
Score Style`scoreStyle`	Number `number` Badge `badge` Face `face`
Score Position`scorePosition`	Left `left` Center `center` Right `right`
Change vs`deltaReference`	Previous wave `previous` First wave `first` Target `target`
Colour Score by Band`colorByBand`	On / off
Good from`bandGood`	Number
Poor below`bandPoor`	Number
Score Label`scoreLabel`	Text
Animate Score`animateScore`	On / off
Show 0–10 Histogram`showHistogram`	On / off
Trend Smoothing`rollingWaves`	None `1` 3-wave rolling average `3`
Sort Segments`segmentSort`	Data order `data` By score `score` By change vs previous wave `change`
Focus on Significant Cells`focusSignificant`	On / off
Transpose (segments as rows)`transpose`	On / off
Show Search Box`showSearch`	On / off
Show Change vs Previous Wave`showWaveDelta`	On / off
Show Trend Column`showSparkline`	On / off
Show CSV Export`exportEnabled`	On / off
Show Margin of Error (±)`showMarginOfError`	On / off
Show Confidence Band on Trend`showConfidenceBand`	On / off
Mark Cells Above / Below Total`testVsTotal`	On / off

Score Mapping`mapping`

Setting	Type and options
Detractors Up To`detractorMax`	Number
Promoters From`promoterMin`	Number

Target (Premium)`target`

Setting	Type and options
Show Target`show`	On / off
Target Score`value`	Number
Label`label`	Text
Color (empty = theme)`color`	Colour
Show Gap to Target`showGapHint`	On / off

Significance (Premium)`significance`

Setting	Type and options
Significance Testing`enabled`	On / off
Confidence Level`confidence`	90 % `90` 95 % `95` 99 % `99`
Min Base for Testing`minBase`	Number
Multiple-Comparison Correction`correction`	None (agency convention) `none` Bonferroni `bonferroni`
Higher / Letters (empty = theme)`positiveColor`	Colour
Lower (empty = theme)`negativeColor`	Colour
Explain Letters in Footer`showLetterLegend`	On / off
Hatch Low Bases`lowBaseHatch`	On / off

Smart Caption`insights`

Setting	Type and options
Show Caption`show`	On / off
Position`position`	Top `top` Bottom `bottom`

Footnote`footnote`

Setting	Type and options
Show Footnote`show`	On / off
Template ({base} {n} {neff} {wave} {question} {source})`template`	Text
Source`source`	Text

Dimensions`groupSettings`

Setting	Type and options
Dimension Score Bars`groupBars`	On / off

Setting a value in PBIR

In a visual.json, a setting goes under visual.objects, by card and internal name. Toggles take true or false, choices and text a value in single quotes ('auto'), numbers a D suffix (12D).

"visual": {
  "visualType": "smartvisualsResearch504A0517F073481E943E5262BDB5B9D4",
  "objects": {
    "viewSettings": [{
      "properties": {
        "showTabs": { "expr": { "Literal": { "Value": "true" } } }
      }
    }]
  }
}

SmartVisuals Research fields and settings

Fields

ViewviewSettings

Themetheme

ScalescaleSettings

ColorscolorSettings

BarsbarSettings

Answer ColorsanswerColors

LabelslabelSettings

Nets & Means (Premium)netSettings

SortingsortSettings

LegendlegendSettings

Displaydisplay

Score Mappingmapping

Target (Premium)target

Significance (Premium)significance

Smart Captioninsights

Footnotefootnote

DimensionsgroupSettings