# Punchcard Visualization Options

**Component Reference:** Punchcard or @splunk/visualizations/punchcard

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

| Option | Type | Default | Description |
| --- | --- | --- | --- |
| `backgroundColor` | string | `> themes.defaultBackgroundColor` | Specify the color used for the background. The default for enterprise light is "#ffffff". The default for enterprise dark is "#000000". The default for prisma dark is "#0b0c0e". 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]+)?\\$` |
| `bubbleColor` | string \| array<unknown> | `> size \| gradient(bubbleColorConfig)` | Specify the coloring method used for the bubbles when the colorMode “dynamic” is specified. For example “> size \| gradient(bubbleColorConfig)". |
| `bubbleLabelDisplay` | string | `all` | Specify whether all bubble labels, the max value bubble labels, or none of the bubble labels should be displayed. Allowed values: `all`, `max`, `off` |
| `bubbleRadiusMax` | number | `15` | Specify the max radius (in pixels) of the bubbles when showDynamicBubbleSize option is false. Greater than 0. |
| `bubbleRadiusMin` | number | `1` | Specify the min radius (in pixels) of the bubbles when showDynamicBubbleSize option is false. Greater than 0. |
| `bubbleRowScale` | string | `global` | Specify how bubbles are scaled relative to other rows. Allowed values: `global`, `row` |
| `bubbleSizeMax` | number | `1` | Specify the max percentage (in decimal format) of space a bubble should take up within a cell when showDynamicBubbleSize option is true. The number specified must be between 0 and 1. |
| `bubbleSizeMethod` | string | `area` | Specify whether bubble area or diameter corresponds to the size value. Allowed values: `radius`, `area` |
| `bubbleSizeMin` | number | `0.25` | Specify the min percentage (in decimal format) of space a bubble should take up within a cell when showDynamicBubbleSize option is true. The number specified must be between 0 and 1. |
| `category` | array<string \| number> | `> primary \| seriesByIndex(3)` | Specify the dataSource to apply series categories. Items: string \| number |
| `categoryField` | string | `> category \| getField()` | Specify the field that should be mapped to the series categories. |
| `colorMode` | string | `dynamic` | Specify the coloring method used for the bubbles. Allowed values: `categorical`, `dynamic` |
| `legendDisplay` | string | `right` | Specify the location of the legend on the panel. Allowed values: `right`, `off` |
| `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 colors used for a series. For example, "#FF0000", "#0000FF", "#008000". Items: string |
| `showDefaultSort` | boolean | `false` | Specify whether axes should be sorted based on order of time, digits and strings. |
| `showDynamicBubbleSize` | boolean | `true` | Specify whether the bubble size should be dynamic or fixed. |
| `showMaxValuePulsation` | boolean | `true` | Specify whether the max value bubble should pulsate. |
| `size` | array<number> | `> primary \| seriesByIndex(2)` | Specify the dataSource to apply 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 |
| `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 |
| `yField` | string | `> y \| getField()` | Specify the field that should be mapped to the y-axis. |

_Auto-generated; do not edit by hand._
