Skip to content

UsePlacementOptions

UsePlacementOptions = object

Options for the usePlacement hook.

optional autoLoad?: boolean

Automatically load a decision on mount. Default true.


optional contextMode?: RevTurbineContextMode

Context resolution mode. Default 'auto'.


optional overrides?: RevTurbinePlacementDecisionOverrides

Override segment, plan, or usage for testing.


optional placement?: RevTurbinePlacementConfig

Placement configuration (name, scope key, metadata).


optional surfaceSlot?: RevTurbineSurfaceSlotConfig

Canonical surface slot configuration (preferred over placement).


optional traits?: Record<string, string | number | boolean>

Custom traits to include in the decision request.


optional ttlMs?: number

Decision cache TTL in milliseconds.


optional userId?: string

Target user ID. Falls back to the SDK’s current user context.