# Timeline Visualization Options

**Component Reference:** Timeline or @splunk/visualizations/timeline

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

| Option | Type | Default | Description |
| --- | --- | --- | --- |
| `additionalTooltipFields` | array<string> | `[]` | Specify the fields to add to the default set of tooltips. Tooltips appear when you hover over events. These fields and their corresponding values are shown in addition to the ones displayed by default. Items: string |
| `backgroundColor` | string | `> themes.defaultBackgroundColor` | Specify the color for the background. You may use a data source to apply the color. 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]+)?\\$` |
| `category` | array<string \| number> | `> primary\| seriesByName("category")` | Specify the data source to apply series categories. This will color events in distinct categories. Items: string \| number |
| `categoryField` | string | `> category \| getField()` | Specify the field that should be mapped to the y-axis. |
| `dataColors` | string \| array<string> | — | Specify the colors to use for events. You can use an array of colors to be picked from, or you can use a data source to apply dynamic coloring. For example, “> primary \| seriesByName("count") \| rangeValue(lowToHigh)”. By default, the dataColors option is not defined and seriesColors is used for categorical coloring. Items: string |
| `duration` | array<string \| number> | `> primary \| seriesByPrioritizedTypes("number", "time")` | Specify the data source to apply duration to events. This will display events over a length of time as a bar rather than a circle. Items: string \| number |
| `durationField` | string | `> duration \| getField()` | Specify the field that should be mapped to the x-axis. |
| `durationUnit` | string | `milliseconds` | Specify the unit of the values in the duration data source used to apply duration to events. Allowed values: `milliseconds`, `seconds`, `minutes`, `hours` |
| `legendDisplay` | string | `off` | Specify the location of the legend on the panel. Allowed values: `right`, `bottom`, `off` |
| `legendTruncation` | string | `ellipsisEnd` | Specify how to display legend labels when they overflow the layout boundaries by replacing overflow text with an ellipsis. Allowed values: `ellipsisEnd`, `ellipsisMiddle`, `ellipsisStart`, `ellipsisOff` |
| `resultLimit` | number | `10000` | Specify the maximum number of events to render on the timeline. Adjust the value to improve performance. |
| `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 |
| `x` | array<string \| number> | `> primary \| seriesByType("time")` | Specify the data source 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 \| seriesByPrioritizedTypes("string", "number")` | Specify the data source applied to the y-axis. Items: string \| number |
| `yAxisLabelWidth` | number | `100` | Specify the width, in pixels, for y-axis labels. |
| `yField` | string | `> y \| getField()` | Specify the field that should be mapped to the y-axis. |

_Auto-generated; do not edit by hand._
