# Bubble Visualization Options

**Component Reference:** Bubble or @splunk/visualizations/bubble

Source: `@splunk/visualization-schemas/bubbleOptionsSchema`

| Option | Type | Default | Description |
| --- | --- | --- | --- |
| `backgroundColor` | string | `> themes.defaultBackgroundColor` | Specify the color used for the chart background by using a hexadecimal code. For example, #0000FF. Pattern: `^#(?:[0-9a-fA-F]{3,4}\|[0-9a-fA-F]{6}\|[0-9a-fA-F]{8})$\|^transparent$\|^rgb\\(\\s*(\\d{1,3}),\\s*(\\d{1,3}),\\s*(\\d{1,3})\\)$\|^rgba\\(\\s*(\\d{1,3}%?),\\s*(\\d{1,3}%?),\\s*(\\d{1,3}%?),\\s*(\\d*(?:\\.\\d+)?)\\)$\|\\$(\\w+:)?([^$\|:]+?)(\\\|[\|\\w]+)?\\$` |
| `bubbleSizeMax` | number | `50` | Specify, in pixels, the maximum size of each bubble. |
| `bubbleSizeMethod` | string | `area` | Specify how bubble size is measured. Allowed values: `area`, `diameter` |
| `bubbleSizeMin` | number | `10` | Specify, in pixels, the minimum size of each bubble. |
| `category` | array<string \| number> | — | Specify a sequence of dataSource events to be plotted on the chart. Items: string \| number |
| `categoryField` | string | `> category \| getField()` | Specify the field that should be mapped to the series categories. |
| `legendDisplay` | string | `right` | Specify the location of the legend on the panel. Allowed values: `right`, `left`, `top`, `bottom`, `off` |
| `legendTruncation` | string | `ellipsisEnd` | Specify where to use ellipsis to replace legend labels that overflow the layout. Allowed values: `ellipsisEnd`, `ellipsisMiddle`, `ellipsisStart`, `ellipsisOff` |
| `resultLimit` | number | `50000` | Specify the number of data points rendered in a chart. |
| `seriesColors` | array<string> | `["#7B56DB","#009CEB","#00CDAF","#DD9900","#FF677B","#CB2196","#813193","#0051B5","#008C80","#99B100","#FFA476","#FF6ACE","#AE8CFF","#00689D","#00490A","#465D00","#9D6300","#F6540B","#FF969E","#E47BFE"]` | Specify the hexadecimal color codes for the bubble order from largest to smallest. For example, ["#FF0000", "#0000FF", "#008000"]. Items: string |
| `seriesColorsByField` | object | — | Specify the colors to use for specific categories, or series names, derived from distinct values in the selected category field. For example, {"user1": "#008000", "user2": "#FFA500"}. |
| `showRoundedXAxisLabels` | boolean | `false` | Specify whether to round x-axis values to the nearest integer. |
| `showXAxisExtendedRange` | boolean | `true` | Specify whether the x-axis should be extended to snap to whole major tick marks. |
| `showXAxisWithZero` | boolean | `false` | Specify whether the x-axis range includes zero. |
| `showXMinorGridLines` | boolean | `false` | Specify whether minor grid lines are visible on the x-axis. |
| `showYAxisExtendedRange` | boolean | `true` | Specify whether the y-axis should be extended to snap to whole major tick marks. |
| `showYAxisWithZero` | boolean | `false` | Specify whether the y-axis range includes zero. |
| `showYMajorGridLines` | boolean | `true` | Specify whether major grid lines are visible on the y-axis. |
| `showYMinorGridLines` | boolean | `false` | Specify whether minor grid lines are visible on the y-axis. |
| `size` | array<number> | `> primary \| seriesByIndex(2)` | Specify the dataSource events that are represented by the bubble size in the chart. Items: number |
| `sizeField` | string | `> size \| getField()` | Specify the field that should be mapped to the bubble size in the chart. |
| `x` | array<string \| number> | `> primary \| seriesByIndex(0)` | Specify the dataSource applied to the x-axis. Items: string \| number |
| `xAxisAbbreviation` | string | `off` | Specify whether to abbreviate large x-axis values with the closest International System of Units (SI) prefix. Allowed values: `off`, `auto` |
| `xAxisLabelRotation` | number | `0` | Specify the rotation of the x-axis labels in degrees. Allowed values: `-90`, `-45`, `0`, `45`, `90` |
| `xAxisLabelVisibility` | string | `auto` | Specify whether to show or hide labels on the x-axis. Allowed values: `auto`, `show`, `hide` |
| `xAxisLineVisibility` | string | `hide` | Specify whether to show the x-axis line. Allowed values: `hide`, `show` |
| `xAxisMajorTickInterval` | string \| number | `auto` | Specify the spacing interval between major tick marks along the x-axis. By default, the spacing value is automatically calculated based on the scale of the related axis. |
| `xAxisMajorTickSize` | number | `6` | Specify the size, in pixels, of major tick marks on the x-axis. |
| `xAxisMajorTickVisibility` | string | `auto` | Specify whether to show or hide major tick marks on the x-axis. Allowed values: `auto`, `show`, `hide` |
| `xAxisMax` | string \| number | `auto` | Specify the maximum value for the visible x-axis range. |
| `xAxisMin` | string \| number | `auto` | Specify the minimum value for the visible x-axis range. |
| `xAxisMinorTickSize` | number | `6` | Specify the size, in pixels, of minor tick marks on the x-axis. |
| `xAxisMinorTickVisibility` | string | `auto` | Specify whether to show or hide minor tick marks on the x-axis . Allowed values: `auto`, `show`, `hide` |
| `xAxisScale` | string | `linear` | Specify the type of scale that applies to a numerical x-axis. Allowed values: `linear`, `log` |
| `xAxisTitleText` | string | — | Specify the title of the x-axis. |
| `xAxisTitleVisibility` | string | `show` | Specify whether to hide the title of the x-axis. Allowed values: `hide`, `show` |
| `xField` | string | `> x \| getField()` | Specify the field that should be mapped to the x-axis. |
| `y` | array<string \| number> | `> primary \| seriesByIndex(1)` | Specify the dataSource applied to the y-axis. Items: string \| number |
| `yAxisAbbreviation` | string | `auto` | Specify whether to abbreviate large y-axis values with the closest International System of Units (SI) prefix. Allowed values: `off`, `auto` |
| `yAxisLabelVisibility` | string | `auto` | Specify whether to show or hide labels on the y-axis. Allowed values: `auto`, `show`, `hide` |
| `yAxisLineVisibility` | string | `hide` | Specify whether to show the y-axis line. Allowed values: `hide`, `show` |
| `yAxisMajorTickInterval` | string \| number | `auto` | Specify the spacing interval between major tick marks along the y-axis. By default, the spacing value is automatically calculated based on the scale of the related axis. |
| `yAxisMajorTickSize` | number | `6` | Specify the size, in pixels, of major tick marks on the y-axis. |
| `yAxisMajorTickVisibility` | string | `auto` | Specify whether to show or hide major tick marks on the y-axis. Allowed values: `auto`, `show`, `hide` |
| `yAxisMax` | string \| number | `auto` | Specify the maximum value for the visible y-axis range. |
| `yAxisMin` | string \| number | `auto` | Specify the minimum value for the visible y-axis range. |
| `yAxisMinorTickSize` | number | `6` | Specify the size, in pixels, of minor tick marks on the y-axis. |
| `yAxisMinorTickVisibility` | string | `auto` | Specify whether to show or hide minor tick marks on the y-axis. Allowed values: `auto`, `show`, `hide` |
| `yAxisScale` | string | `linear` | Specify the type of scale that applies to a numerical y-axis. Allowed values: `linear`, `log` |
| `yAxisTitleText` | string | — | Specify the title of the y-axis. |
| `yAxisTitleVisibility` | string | `show` | Specify whether to hide the title of the y-axis. Allowed values: `hide`, `show` |
| `yField` | string | `> y \| getField()` | Specify the field that should be mapped to the y-axis. |

_Auto-generated; do not edit by hand._
