Scatter & Bubble fields and settings
Every field well and every setting in the format pane of version 1.0.0.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 Scatter & Bubble page; every setting works in edit mode with or without one.
16 fields · 27 cards · 179 settings Markdown for AI assistantscatalog.json
Fields
| Field | Takes | Needed | What it is for |
|---|---|---|---|
Detailsdetails | Column | Optional | Point identity (customer, product, region…). One point per value. |
Xx | Measure | Optional | Numeric value on the horizontal axis. |
Yy | Measure | Optional | Numeric value on the vertical axis. |
Sizesize | Measure | Optional | Bubble area proportional to the value (area-true). |
Legendlegend | Column | Optional | Colour (and optional shape) by this field. |
Labellabel | Column | Optional | Text for data labels, when different from Details. |
Play AxisplayAxis | Column | Optional | Date or ordered field: one frame per value, with play, slider and trails. |
Annotationannotation | Column | Optional | Text shown as a callout next to the point (blank = none). |
Imageimage | Column | Optional | Image per point as a data:image URL (base64); drawn in the marker. Web URLs are ignored (no external calls). |
Prior XpriorX | Measure | Optional | Premium. X in the comparison period: draws movement and migration counts. |
Prior YpriorY | Measure | Optional | Premium. Y in the comparison period. |
Small MultiplessmallMultiples | Column | Optional | Premium. One panel per value, statistics per panel. |
Tooltipstooltips | Measure | Optional · up to 10 | Extra measures in the tooltip. |
X SplitxSplit | Measure | Optional | Benchmark for the vertical quadrant line (e.g. target growth). |
Y SplitySplit | Measure | Optional | Benchmark for the horizontal quadrant line (e.g. target margin). |
Weightweight | Measure | Optional | Premium. Per-point weight for weighted least squares. |
Themetheme
| Setting | Type and options |
|---|---|
Style TemplatetemplateApply a named preset to several cards at once; the dropdown shows the one in use. Edit any setting afterwards and it shows Custom. Default restores the style defaults. |
|
ThemeselectedTheme |
|
Transparent BackgroundtransparentBg | On / off |
Background Colorbackground | Colour |
Markersmarkers
| Setting | Type and options |
|---|---|
ColorfillEmpty follows the theme palette by legend. Use fx for rules or field values. | Colour |
Shapeshape |
|
Size (px)markerSize | Number |
Opacity (%)opacity | Number |
Border WidthborderWidth | Number |
Border ColorborderColor | Colour |
Auto-Fit Marker SizeautoFitShrink markers when many points share the plot, so dense data stays readable. | On / off |
Draw OrderdrawOrderWhich points sit on top. Selected and highlighted points always come to the front. |
|
Bubble Sizebubble
| Setting | Type and options |
|---|---|
Minimum Radius (px)minRadius | Number |
Maximum Radius (px)maxRadius | Number |
X AxisxAxis
| Setting | Type and options |
|---|---|
Showshow | On / off |
Titletitle | On / off |
Title TexttitleText | Text |
Scalescale |
|
Invertinvert | On / off |
Minimummin | Text |
Maximummax | Text |
Gridlinesgridlines | On / off |
Grid ColorgridColor | Colour |
Font SizefontSize | Number |
Font ColorfontColor | Colour |
Y AxisyAxis
| Setting | Type and options |
|---|---|
Showshow | On / off |
Titletitle | On / off |
Title TexttitleText | Text |
Scalescale |
|
Invertinvert | On / off |
Minimummin | Text |
Maximummax | Text |
Gridlinesgridlines | On / off |
Grid ColorgridColor | Colour |
Font SizefontSize | Number |
Font ColorfontColor | Colour |
Legendlegend
| Setting | Type and options |
|---|---|
Showshow | On / off |
Positionposition |
|
Titletitle | On / off |
Font SizefontSize | Number |
Font ColorfontColor | Colour |
Data Labelslabels
| Setting | Type and options |
|---|---|
Showmode |
|
Top NtopN | Number |
Font SizefontSize | Number |
Font ColorfontColor | Colour |
Leader LinesleaderLines | On / off |
Halobackground | On / off |
Highlight Points NamedhighlightTextPoints whose label contains this text are emphasised and always labelled; the rest are dimmed. | Text |
Top N PointspointFilter
| Setting | Type and options |
|---|---|
Keepby |
|
Nn | Number |
Quadrantsquadrants
| Setting | Type and options |
|---|---|
Showshow | On / off |
X SplitxRule |
|
X ValuexValue | Number |
Y SplityRule |
|
Y ValueyValue | Number |
Top-Left LabeltlLabel | Text |
Top-Right LabeltrLabel | Text |
Bottom-Left LabelblLabel | Text |
Bottom-Right LabelbrLabel | Text |
Top-Left FilltlFill | Colour |
Top-Right FilltrFill | Colour |
Bottom-Left FillblFill | Colour |
Bottom-Right FillbrFill | Colour |
Default TintstintSubtle tints when no fill is set: top-right green, bottom-left orange, the others grey. | On / off |
Show CountsshowCounts | On / off |
Label Font SizefontSizeSize of the quadrant and zone names and counts. | Number |
Label Font ColorfontColor | Colour |
Color Points By Quadrant / ZonecolorPoints | On / off |
Zones (Beyond 2×2)zones
| Setting | Type and options |
|---|---|
ShowshowPremium. Split the plane into a grid of up to 8×8 zones with counts, heat shading and a zone table. Replaces quadrants. | On / off |
Columnscols | Number |
Rowsrows | Number |
X CutsxMethod |
|
X Custom CutsxCuts | Text |
Y CutsyMethod |
|
Y Custom CutsyCuts | Text |
Better DirectionbetterWhich way is good. Drives heat shading and improved / declined movement. |
|
Heat Shadingheat |
|
Heat Opacity (%)heatOpacity | Number |
Show CountsshowCounts | On / off |
Zone Tabletable |
|
Side Tablestables
| Setting | Type and options |
|---|---|
Font SizefontSizeZone table, coefficient table and migration matrix. | Number |
Font ColorfontColor | Colour |
Movement vs Prior Periodmovement
| Setting | Type and options |
|---|---|
ShowshowPremium. Needs Prior X and Prior Y. Draws where each point came from and counts zone migrations. | On / off |
Stylestyle |
|
Color BycolorBy |
|
Line WidthlineWidth | Number |
Hide Moves Below (% of plot)minMove | Number |
Better Direction (No Zones)better |
|
Migration Summary In CaptionshowSummary | On / off |
Migration MatrixshowMatrix | On / off |
Trend Linetrend
| Setting | Type and options |
|---|---|
Showshow | On / off |
FitfitTypeLinear is free. Other fits are premium. |
|
Per SeriesperSeriesPremium. One fit per legend value. | On / off |
Show EquationshowEquation | On / off |
Show R²showRSquared | On / off |
BandbandTypePremium. Shaded uncertainty band around the fit. |
|
Band LevelbandLevel |
|
Coefficient Table (p-values)showStatsPremium. Coefficients, standard errors, t, p, R², adjusted R², F test. | On / off |
LOESS Span (%)loessSpan | Number |
Line Colorcolor | Colour |
Line Widthwidth | Number |
Correlationcorrelation
| Setting | Type and options |
|---|---|
Show In Captionshow | On / off |
Methodmethod |
|
Show 95% Confidence IntervalshowCI | On / off |
Outliersoutliers
| Setting | Type and options |
|---|---|
Flag Far From TrendbasicFlagRing points whose standardised residual exceeds the threshold. | On / off |
ThresholdbasicThreshold |
|
Multivariate Outliers (Mahalanobis)mahalanobisPremium. Flag points outside the 97.5% ellipse of a bivariate normal (χ², 2 df), independent of any fit. | On / off |
Influence DiagnosticsdiagnosticsPremium. Studentized residual > 3, Cook's D > 4/n, leverage > 2p/n, with the reason in the tooltip. | On / off |
Clustersclusters
| Setting | Type and options |
|---|---|
ShowshowPremium. k-means on standardised X and Y (fixed seed, reproducible). | On / off |
Methodmethod |
|
DBSCAN Radius (SD units)eps | Number |
DBSCAN Minimum PointsminSamples | Number |
Auto k (Silhouette)autoK | On / off |
Number Of Clustersk | Number |
HullsshowHulls | On / off |
Color Points By ClustercolorPoints | On / off |
Confidence Ellipsesellipses
| Setting | Type and options |
|---|---|
ShowshowPremium. Bivariate-normal confidence ellipse (χ², 2 df) for all points, each series or each cluster. | On / off |
One PergroupBy |
|
Levellevel |
|
Density Layerdensity
| Setting | Type and options |
|---|---|
ShowshowPremium. Kernel density shading for dense or overplotted data. | On / off |
Stylestyle |
|
Bandwidth (px)bandwidth | Number |
Hexagon Size (px)hexSize | Number |
Opacity (%)opacity | Number |
Palettepalette |
|
Show PointsshowPoints | On / off |
Small MultiplessmallMultiples
| Setting | Type and options |
|---|---|
Columns (0 = Auto)columnsPremium. Bind a field to Small Multiples: one panel per value, statistics per panel. | Number |
Shared AxessharedAxes | On / off |
Panel Title SizetitleSize | Number |
Panel Title ColortitleColor | Colour |
Reference LinesreferenceLines
| Setting | Type and options |
|---|---|
X ConstantxConstant | On / off |
X Constant ValuexConstantValue | Number |
X MeanxMean | On / off |
X MedianxMedian | On / off |
Y ConstantyConstant | On / off |
Y Constant ValueyConstantValue | Number |
Y MeanyMean | On / off |
Y MedianyMedian | On / off |
X Min And MaxxMinMax | On / off |
Y Min And MaxyMinMax | On / off |
X PercentilexPercentile | On / off |
X Percentile (%)xPercentileValue | Number |
Y PercentileyPercentile | On / off |
Y Percentile (%)yPercentileValue | Number |
y = x Linesymmetry | On / off |
Symmetry ShadingsymmetryShadingShade the areas above and below y = x. | On / off |
Ratio Line (y = k·x)ratio | On / off |
Ratio kratioValue | Number |
Line ColorlineColor | Colour |
Line WidthlineWidth | Number |
StylelineStyle |
|
Play AxisplayAxis
| Setting | Type and options |
|---|---|
Frame Duration (ms)speed | Number |
Looploop | On / off |
Trailstrails |
|
Start FramestartFrameThe frame shown when the report opens (and in exports). |
|
Font SizefontSize | Number |
Frame NameframeNameThe current frame (e.g. the year) drawn large and faint behind the points. | On / off |
Frame Name Size (0 = Auto)frameNameSize | Number |
Annotationsannotations
| Setting | Type and options |
|---|---|
ShowshowBind a text field to Annotation: points with a value get a callout. | On / off |
Font SizefontSize | Number |
Font ColorfontColor | Colour |
Callout Boxbackground | On / off |
Interactioninteraction
| Setting | Type and options |
|---|---|
Lasso Select (Shift + Drag)lasso | On / off |
Zoom (Wheel) And Pan (Drag)zoomDouble-click resets the view. | On / off |
Jitterjitter | On / off |
Jitter Amount (%)jitterAmount | Number |
Zoom HintzoomHint"Zoomed: double-click to reset" after zooming; drawn in the footnote's size and colour. | On / off |
Captioncaption
| Setting | Type and options |
|---|---|
Showshow | On / off |
Font SizefontSize | Number |
Font ColorfontColor | Colour |
Footnotefootnote
| Setting | Type and options |
|---|---|
Showshow | On / off |
Font SizefontSize | Number |
Font ColorfontColor | Colour |
Accessibilityaccessibility
| Setting | Type and options |
|---|---|
Focus Outline ColorfocusColorEmpty follows the theme; high contrast always uses the system colour. | Colour |
Focus Outline Width (px)focusWidth | Number |
Minimum Text Size (px)minFontSizeNo text is drawn smaller than this. | Number |
Reduce MotionreduceMotionWith reduced motion the play axis never advances on its own; Play steps one frame. |
|
Shapes By SeriesnonColorCueDistinct marker shapes per legend value, so meaning never depends on colour alone. | On / off |
Data ColorsdataColors
| Setting | Type and options |
|---|---|
Colorfill | Colour |
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": "smartVisualsScatter4A7F2E8C1B3D5690F2A8C4E7B1D93F56",
"objects": {
"theme": [{
"properties": {
"transparentBg": { "expr": { "Literal": { "Value": "true" } } }
}
}]
}
}