# stateRestorationActivity(for:) Returns a user activity object encapsulating the current state of the specified scene. ``` optional func stateRestorationActivity(for scene: UIScene) -> NSUserActivity? ``` ## Parameters `scene` The scene whose state information is needed. ## Discussion Use this method to return an object with information about your scene’s current state. Save enough information to be able to restore that state again after UIKit disconnects and then reconnects the scene. User activity objects are a mechanism to record what the user is doing, so you don’t need to manually persist the state of your scene’s UI. After calling this method, and before archiving the object and saving it to disk, UIKit lets you add state information as follows: - If you set a delegate for the object in your app, UIKit calls the delegate’s method. - If you assign the object to the [`userActivity`](/documentation/UIKit/UIResponder/userActivity) property of any responders, UIKit calls each responder’s [`updateUserActivityState(_:)`](/documentation/UIKit/UIResponder/updateUserActivityState(_:)) method. When reconnecting the scene and restoring state, the user activity provided by this method will be provided in the [`stateRestorationActivity`](/documentation/UIKit/UISceneSession/stateRestorationActivity) property of [`UISceneSession`](/documentation/UIKit/UISceneSession). --- 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)