# UserJourneyTraceConfig

**Kind**: interface | **Module**: [Insights](https://docs.interop.io/desktop/reference/javascript/insights/index.md)

**Source**: https://docs.interop.io/desktop/reference/javascript/insights/userjourneytraceconfig/index.html

Configuration for User Journey trace behavior.
Controls how significant User Journey milestones are tracked throughout the platform session.

## Properties

- **`chainLength`** (`number`, optional) default: `0`
  If specified, this number of previously focused applications and their focus times will be added as attributes to
  the User Journey span. This is useful for some kinds of querying.
- **`descriptiveName`** (`boolean`, optional) default: `true`
  If `true`, the User Journey trace spans will be named interopio.desktop.userJourney.<event>.<applicationName>.
  If `false`, the User Journey trace spans will be named interopio.api.userJourney.<event>
- **`enabled`** (`boolean`, required)
  Whether the User Journey trace is enabled.
- **`structure`** (`"sibling" | "nested"`, optional) default: `"sibling"`
  If `sibling`, all spans in the User Journey trace will be nested under the same
  root span. This is useful when working with visualization interfaces that do not handle
  arbitrarily nested spans.

  If `nested`, every span in the User Journey trace will be nested under the previous span.
  This is useful for some kinds of querying.