# reportTransitionToStateLabel:stableMetadata:volatileMetadata: Reports a transition to a new state. ``` - (void) reportTransitionToStateLabel:(NSString *) stateLabel stableMetadata:(NSDictionary *) stableMetadata volatileMetadata:(NSDictionary *) volatileMetadata; ``` ## Parameters `stateLabel` A descriptive label for the new state, which must not be empty, or `nil` to clear the active state. `stableMetadata` An optional dictionary with `NSString` keys that identifies the state together with `stateLabel`. Dictionary values must be `NSNumber`, `NSString`, or `NSDate`. Passing values of any other type is a programmer error and will raise an exception. `volatileMetadata` An optional dictionary with `NSString` keys providing context likely to change within this state. Dictionary values must be `NSNumber`, `NSString`, or `NSDate`. Passing values of any other type is a programmer error and will raise an exception. ## Discussion A transition occurs only when `stateLabel` or `stableMetadata` changes from the current state. If both are equal to the current values, this call is a no-op. Pass `nil` for `stateLabel` to indicate that no state is currently active, clearing any previously reported state. Any volatile metadata from the previous state is discarded when a new transition begins. Calling this method more frequently than user interaction timescales can trigger rate limiting, causing state updates to go unlogged. --- Copyright © 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)