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

    FieldTakesNeededWhat it is for
    DetailsdetailsColumnOptionalPoint identity (customer, product, region…). One point per value.
    XxMeasureOptionalNumeric value on the horizontal axis.
    YyMeasureOptionalNumeric value on the vertical axis.
    SizesizeMeasureOptionalBubble area proportional to the value (area-true).
    LegendlegendColumnOptionalColour (and optional shape) by this field.
    LabellabelColumnOptionalText for data labels, when different from Details.
    Play AxisplayAxisColumnOptionalDate or ordered field: one frame per value, with play, slider and trails.
    AnnotationannotationColumnOptionalText shown as a callout next to the point (blank = none).
    ImageimageColumnOptionalImage per point as a data:image URL (base64); drawn in the marker. Web URLs are ignored (no external calls).
    Prior XpriorXMeasureOptionalPremium. X in the comparison period: draws movement and migration counts.
    Prior YpriorYMeasureOptionalPremium. Y in the comparison period.
    Small MultiplessmallMultiplesColumnOptionalPremium. One panel per value, statistics per panel.
    TooltipstooltipsMeasureOptional · up to 10Extra measures in the tooltip.
    X SplitxSplitMeasureOptionalBenchmark for the vertical quadrant line (e.g. target growth).
    Y SplitySplitMeasureOptionalBenchmark for the horizontal quadrant line (e.g. target margin).
    WeightweightMeasureOptionalPremium. Per-point weight for weighted least squares.

    Themetheme

    SettingType 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.
    • Default none
    • Executive executive
    • Analyst analyst
    • Presentation presentation
    • Minimal minimal
    • Print print
    • Custom custom
    ThemeselectedTheme
    • SmartVisuals smartvisuals
    • Dark dark
    • Clean clean
    • Slate slate
    Transparent BackgroundtransparentBgOn / off
    Background ColorbackgroundColour

    Markersmarkers

    SettingType and options
    ColorfillEmpty follows the theme palette by legend. Use fx for rules or field values.Colour
    Shapeshape
    • Circle circle
    • Square square
    • Diamond diamond
    • Triangle triangle
    • Cross cross
    • Star star
    Size (px)markerSizeNumber
    Opacity (%)opacityNumber
    Border WidthborderWidthNumber
    Border ColorborderColorColour
    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.
    • Largest first (small on top) size
    • By X x
    • By Y y
    • Data order data

    Bubble Sizebubble

    SettingType and options
    Minimum Radius (px)minRadiusNumber
    Maximum Radius (px)maxRadiusNumber

    X AxisxAxis

    SettingType and options
    ShowshowOn / off
    TitletitleOn / off
    Title TexttitleTextText
    Scalescale
    • Linear linear
    • Logarithmic log
    InvertinvertOn / off
    MinimumminText
    MaximummaxText
    GridlinesgridlinesOn / off
    Grid ColorgridColorColour
    Font SizefontSizeNumber
    Font ColorfontColorColour

    Y AxisyAxis

    SettingType and options
    ShowshowOn / off
    TitletitleOn / off
    Title TexttitleTextText
    Scalescale
    • Linear linear
    • Logarithmic log
    InvertinvertOn / off
    MinimumminText
    MaximummaxText
    GridlinesgridlinesOn / off
    Grid ColorgridColorColour
    Font SizefontSizeNumber
    Font ColorfontColorColour

    Legendlegend

    SettingType and options
    ShowshowOn / off
    Positionposition
    • Top top
    • Bottom bottom
    TitletitleOn / off
    Font SizefontSizeNumber
    Font ColorfontColorColour

    Data Labelslabels

    SettingType and options
    Showmode
    • None none
    • Most prominent (Top N) topN
    • All that fit all
    • Extremes per quadrant / zone extremes
    • Selected only selected
    Top NtopNNumber
    Font SizefontSizeNumber
    Font ColorfontColorColour
    Leader LinesleaderLinesOn / off
    HalobackgroundOn / off
    Highlight Points NamedhighlightTextPoints whose label contains this text are emphasised and always labelled; the rest are dimmed.Text

    Top N PointspointFilter

    SettingType and options
    Keepby
    • All points none
    • Top N by size size
    • Top N by Y y
    • Top N by X x
    • Bottom N by Y bottomY
    NnNumber

    Quadrantsquadrants

    SettingType and options
    ShowshowOn / off
    X SplitxRule
    • Median median
    • Mean mean
    • Zero zero
    • Value value
    • Benchmark measure (X / Y Split role) measure
    X ValuexValueNumber
    Y SplityRule
    • Median median
    • Mean mean
    • Zero zero
    • Value value
    • Benchmark measure (X / Y Split role) measure
    Y ValueyValueNumber
    Top-Left LabeltlLabelText
    Top-Right LabeltrLabelText
    Bottom-Left LabelblLabelText
    Bottom-Right LabelbrLabelText
    Top-Left FilltlFillColour
    Top-Right FilltrFillColour
    Bottom-Left FillblFillColour
    Bottom-Right FillbrFillColour
    Default TintstintSubtle tints when no fill is set: top-right green, bottom-left orange, the others grey.On / off
    Show CountsshowCountsOn / off
    Label Font SizefontSizeSize of the quadrant and zone names and counts.Number
    Label Font ColorfontColorColour
    Color Points By Quadrant / ZonecolorPointsOn / off

    Zones (Beyond 2×2)zones

    SettingType 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
    ColumnscolsNumber
    RowsrowsNumber
    X CutsxMethod
    • Equal count (quantiles) quantile
    • Equal width range
    • Custom cuts custom
    X Custom CutsxCutsText
    Y CutsyMethod
    • Equal count (quantiles) quantile
    • Equal width range
    • Custom cuts custom
    Y Custom CutsyCutsText
    Better DirectionbetterWhich way is good. Drives heat shading and improved / declined movement.
    • Up and right upRight
    • Up and left upLeft
    • Down and right downRight
    • Down and left downLeft
    • Up up
    • Down down
    • Right right
    • Left left
    Heat Shadingheat
    • Diverging (bad → good) diverging
    • Sequential sequential
    • None none
    Heat Opacity (%)heatOpacityNumber
    Show CountsshowCountsOn / off
    Zone Tabletable
    • Off off
    • Right right
    • Bottom bottom

    Side Tablestables

    SettingType and options
    Font SizefontSizeZone table, coefficient table and migration matrix.Number
    Font ColorfontColorColour

    Movement vs Prior Periodmovement

    SettingType and options
    ShowshowPremium. Needs Prior X and Prior Y. Draws where each point came from and counts zone migrations.On / off
    Stylestyle
    • Arrow arrow
    • Line line
    • Ghost marker only ghost
    Color BycolorBy
    • Improved / declined direction
    • Series series
    Line WidthlineWidthNumber
    Hide Moves Below (% of plot)minMoveNumber
    Better Direction (No Zones)better
    • Up and right upRight
    • Up and left upLeft
    • Down and right downRight
    • Down and left downLeft
    • Up up
    • Down down
    • Right right
    • Left left
    Migration Summary In CaptionshowSummaryOn / off
    Migration MatrixshowMatrixOn / off

    Trend Linetrend

    SettingType and options
    ShowshowOn / off
    FitfitTypeLinear is free. Other fits are premium.
    • Linear linear
    • Polynomial (2) — premium polynomial2
    • Polynomial (3) — premium polynomial3
    • Logarithmic — premium logarithmic
    • Exponential — premium exponential
    • Power — premium power
    • LOESS smoother — premium loess
    Per SeriesperSeriesPremium. One fit per legend value.On / off
    Show EquationshowEquationOn / off
    Show R²showRSquaredOn / off
    BandbandTypePremium. Shaded uncertainty band around the fit.
    • None none
    • Confidence (mean) confidence
    • Prediction (new point) prediction
    • Both both
    Band LevelbandLevel
    • 90% 90
    • 95% 95
    • 99% 99
    Coefficient Table (p-values)showStatsPremium. Coefficients, standard errors, t, p, R², adjusted R², F test.On / off
    LOESS Span (%)loessSpanNumber
    Line ColorcolorColour
    Line WidthwidthNumber

    Correlationcorrelation

    SettingType and options
    Show In CaptionshowOn / off
    Methodmethod
    • Pearson r pearson
    • Spearman ρ — premium spearman
    • Kendall τ-b — premium kendall
    Show 95% Confidence IntervalshowCIOn / off

    Outliersoutliers

    SettingType and options
    Flag Far From TrendbasicFlagRing points whose standardised residual exceeds the threshold.On / off
    ThresholdbasicThreshold
    • 2
    • 2.5
    • 3
    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

    SettingType and options
    ShowshowPremium. k-means on standardised X and Y (fixed seed, reproducible).On / off
    Methodmethod
    • k-means kmeans
    • Hierarchical (Ward) ward
    • DBSCAN (density, finds noise) dbscan
    DBSCAN Radius (SD units)epsNumber
    DBSCAN Minimum PointsminSamplesNumber
    Auto k (Silhouette)autoKOn / off
    Number Of ClusterskNumber
    HullsshowHullsOn / off
    Color Points By ClustercolorPointsOn / off

    Confidence Ellipsesellipses

    SettingType and options
    ShowshowPremium. Bivariate-normal confidence ellipse (χ², 2 df) for all points, each series or each cluster.On / off
    One PergroupBy
    • All points all
    • Series series
    • Cluster cluster
    Levellevel
    • 90% 90
    • 95% 95
    • 99% 99

    Density Layerdensity

    SettingType and options
    ShowshowPremium. Kernel density shading for dense or overplotted data.On / off
    Stylestyle
    • Shading shading
    • Contours (50/80/95% of points) contours
    • Hexagonal bins hexbin
    Bandwidth (px)bandwidthNumber
    Hexagon Size (px)hexSizeNumber
    Opacity (%)opacityNumber
    Palettepalette
    • Theme theme
    • Heat heat
    • Grey mono
    Show PointsshowPointsOn / off

    Small MultiplessmallMultiples

    SettingType and options
    Columns (0 = Auto)columnsPremium. Bind a field to Small Multiples: one panel per value, statistics per panel.Number
    Shared AxessharedAxesOn / off
    Panel Title SizetitleSizeNumber
    Panel Title ColortitleColorColour

    Reference LinesreferenceLines

    SettingType and options
    X ConstantxConstantOn / off
    X Constant ValuexConstantValueNumber
    X MeanxMeanOn / off
    X MedianxMedianOn / off
    Y ConstantyConstantOn / off
    Y Constant ValueyConstantValueNumber
    Y MeanyMeanOn / off
    Y MedianyMedianOn / off
    X Min And MaxxMinMaxOn / off
    Y Min And MaxyMinMaxOn / off
    X PercentilexPercentileOn / off
    X Percentile (%)xPercentileValueNumber
    Y PercentileyPercentileOn / off
    Y Percentile (%)yPercentileValueNumber
    y = x LinesymmetryOn / off
    Symmetry ShadingsymmetryShadingShade the areas above and below y = x.On / off
    Ratio Line (y = k·x)ratioOn / off
    Ratio kratioValueNumber
    Line ColorlineColorColour
    Line WidthlineWidthNumber
    StylelineStyle
    • Solid solid
    • Dashed dashed
    • Dotted dotted

    Play AxisplayAxis

    SettingType and options
    Frame Duration (ms)speedNumber
    LooploopOn / off
    Trailstrails
    • None none
    • Selected points selected
    • All points all
    Start FramestartFrameThe frame shown when the report opens (and in exports).
    • Latest last
    • First first
    Font SizefontSizeNumber
    Frame NameframeNameThe current frame (e.g. the year) drawn large and faint behind the points.On / off
    Frame Name Size (0 = Auto)frameNameSizeNumber

    Annotationsannotations

    SettingType and options
    ShowshowBind a text field to Annotation: points with a value get a callout.On / off
    Font SizefontSizeNumber
    Font ColorfontColorColour
    Callout BoxbackgroundOn / off

    Interactioninteraction

    SettingType and options
    Lasso Select (Shift + Drag)lassoOn / off
    Zoom (Wheel) And Pan (Drag)zoomDouble-click resets the view.On / off
    JitterjitterOn / off
    Jitter Amount (%)jitterAmountNumber
    Zoom HintzoomHint"Zoomed: double-click to reset" after zooming; drawn in the footnote's size and colour.On / off

    Captioncaption

    SettingType and options
    ShowshowOn / off
    Font SizefontSizeNumber
    Font ColorfontColorColour

    Footnotefootnote

    SettingType and options
    ShowshowOn / off
    Font SizefontSizeNumber
    Font ColorfontColorColour

    Accessibilityaccessibility

    SettingType and options
    Focus Outline ColorfocusColorEmpty follows the theme; high contrast always uses the system colour.Colour
    Focus Outline Width (px)focusWidthNumber
    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.
    • Follow system setting system
    • Always always
    • Off off
    Shapes By SeriesnonColorCueDistinct marker shapes per legend value, so meaning never depends on colour alone.On / off

    Data ColorsdataColors

    SettingType and options
    ColorfillColour

    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" } } }
          }
        }]
      }
    }