# Process Tree Visualization Options

**Component Reference:** Process Tree or @splunk/visualizations/processTree

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

| Option | Type | Default | Description |
| --- | --- | --- | --- |
| `backgroundColor` | string | `> themes.defaultBackgroundColor` | Specify the color for the background. 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]+)?\\$` |
| `expansionPerNode` | array<string \| null> \| string | `[]` | Specify per-node expansion behavior aligned with nodeSource rows. The default 'enable' mode leaves a node expandable and follows the highlighted-node expansion behavior. Use 'expand' to start expanded, 'collapse' to start collapsed, or 'disable' to keep the node expanded without an expansion control. Null or missing entries use the default 'enable' behavior. Provide an array, or use a string DSL expression that resolves to an array. Items: string \| null |
| `fieldsToShowAsChip` | array<string> \| string | `[]` | Specify treeNodeLabelFields names whose values should be rendered as chips. Array values render as comma-separated text inside a single chip. Provide an array, or use a string DSL expression that resolves to an array. Items: string |
| `filterButtonColors` | array<string> \| string | `[]` | Specify optional colors for connection filter buttons (for example #FF0000). Provide an array, or use a string DSL expression that resolves to an array. Items: string |
| `filterButtonFields` | array<string> \| string | `[]` | Specify nodeSource field names used by connection filter buttons. Provide an array, or use a string DSL expression that resolves to an array. Items: string |
| `filterButtonMatchValues` | array<string> \| string | `[]` | Specify match values used by connection filter buttons. Provide an array, or use a string DSL expression that resolves to an array. Items: string |
| `filterButtonNames` | array<string> \| string | `[]` | Specify display names for connection filter buttons. Provide an array, or use a string DSL expression that resolves to an array. Falls back to filterButtonMatchValues when omitted. Items: string |
| `filteredNodeField` | string | — | Specify node field name used to classify which nodes render in the right panel and are excluded from the left tree. |
| `filteredNodeValues` | array<string> \| string | — | Specify field value(s) used with filteredNodeField to classify which nodes render in the right panel. Provide an array, or use a string DSL expression that resolves to an array. Items: string |
| `highlightColor` | string | `rgba(129, 51, 74, 0.82)` | Specify the background color used for the highlighted node row. |
| `highlightedNodeId` | string | `` | Specify a node id to highlight in the process tree. |
| `highlightIcon` | string | `` | Specify an optional built-in icon to render for the highlighted node. Supported values are fire, rectangleDashed, cube, servers, container, geoTag, and layersDoubleTransparent. |
| `highlightIconColor` | string | `` | Specify an optional color override for the highlighted node icon. 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]+)?\\$` |
| `linkValues` | array<number \| string> | `[]` | Specify link values for each link row. Items: number \| string |
| `networkNodeColors` | array<string> \| string | `[]` | Specify optional network node indicator colors aligned with nodeSource rows. These colors apply only to right-side network nodes and the process-side circle indicators for those networks. Provide an array, or use a string DSL expression that resolves to an array. Items: string |
| `nodeColors` | array<string> \| string | `[]` | Specify optional node row background colors aligned with nodeSource rows. These colors can fill process tree rows and right-side network rows unless the node is highlighted. Use networkNodeColors to color network indicators. Provide an array, or use a string DSL expression that resolves to an array. Items: string |
| `nodeIcons` | array<string> \| string | `[]` | Specify optional node icons aligned with nodeSource rows. Supported built-in values are fire, rectangleDashed, cube, servers, container, geoTag, and layersDoubleTransparent. Provide an array, or use a string DSL expression that resolves to an array. Items: string |
| `nodeId` | array<string> | `> nodeSource \| seriesByName("node_id")` | Specify node ids for node metadata lookup when using a secondary node datasource. Items: string |
| `processLimit` | integer | `100` | Specify the number of sibling processes per parent page. Range: min 1 |
| `showFieldName` | boolean | `false` | Specify whether tree node labels render as field=value. When false, only the field value is shown. |
| `source` | array<string> | `> primary \| frameBySeriesTypes("string") \| seriesByIndex(0)` | Specify the source node id for each link row. Items: string |
| `target` | array<string> | `> primary \| frameBySeriesTypes("string") \| seriesByIndex(1)` | Specify the target node id for each link row. Items: string |
| `treeNodeLabelFields` | array<string> \| string | `[]` | Specify nodeSource field names to render in each tree node label, joined by spaces. Array values render as comma-separated text. Empty or null values are skipped. Provide an array, or use a string DSL expression that resolves to an array. Items: string |

_Auto-generated; do not edit by hand._
