---
title: "StateConfiguration"
---
<!-- DO NOT EDIT! This file was auto-generated by crates/build/re_types_builder/src/codegen/docs/website.rs -->

Define the style and mapping for state values in a state timeline view.

This archetype provides configuration for how state values are displayed.
It maps raw state values to display labels, colors, and visibility.

`values`, `labels`, `colors`, and `visible` are parallel arrays: the entry
at index `i` of each describes the same state value, and only the
per-index pairing is meaningful. The four arrays should have matching
length; any secondary array (`labels`, `colors`, `visible`) that is shorter
than `values` falls back to defaults for the missing entries.

It's generally recommended to log this type as static.

The underlying data needs to be logged to the same entity path using [`archetypes.StateChange`](https://rerun.io/docs/reference/types/archetypes/state_change).

## Fields
### Optional
* `values`: [`Text`](../components/text.md)
* `labels`: [`Text`](../components/text.md)
* `colors`: [`Color`](../components/color.md)
* `visible`: [`Visible`](../components/visible.md)


## Can be shown in
* [StateTimelineView](../views/state_timeline_view.md)
* [DataframeView](../views/dataframe_view.md)

## API reference links
 * 🌊 [C++ API docs for `StateConfiguration`](https://ref.rerun.io/docs/cpp/stable/structrerun_1_1archetypes_1_1StateConfiguration.html)
 * 🐍 [Python API docs for `StateConfiguration`](https://ref.rerun.io/docs/python/stable/common/archetypes#rerun.archetypes.StateConfiguration)
 * 🦀 [Rust API docs for `StateConfiguration`](https://docs.rs/rerun/latest/rerun/archetypes/struct.StateConfiguration.html)

## Example

### State changes with a custom style

snippet: archetypes/state_configuration

