<!--
{
  "availability" : [
    "iOS: -",
    "iPadOS: -",
    "macCatalyst: -",
    "tvOS: -",
    "visionOS: -"
  ],
  "documentType" : "symbol",
  "framework" : "UIKit",
  "identifier" : "/documentation/UIKit/UIStateRestoring",
  "metadataVersion" : "0.1.0",
  "role" : "Protocol",
  "symbol" : {
    "kind" : "Protocol",
    "modules" : [
      "UIKit"
    ],
    "preciseIdentifier" : "c:objc(pl)UIStateRestoring"
  },
  "title" : "UIStateRestoring"
}
-->

# UIStateRestoring

Methods for adding objects to your state restoration archives.

```
@MainActor protocol UIStateRestoring : NSObjectProtocol
```

## Overview

You can add state restoring objects to an archive directly or by referencing them from another object that’s preserved, such as a view controller. The methods of the protocol let you save enough information about the object to find or recreate it during the next launch cycle.

When adopting this protocol in your custom objects, you must also remember to register those objects using the [`registerObject(forStateRestoration:restorationIdentifier:)`](/documentation/UIKit/UIApplication/registerObject(forStateRestoration:restorationIdentifier:)) method of the [`UIApplication`](/documentation/UIKit/UIApplication) class. You don’t need to register views or view controllers explicitly because UIKit registers those objects automatically. View controllers adopt this protocol so that they may be used as the restoration parent of one of your custom objects.

## Topics

### Accessing the object information

[`restorationParent`](/documentation/UIKit/UIStateRestoring/restorationParent)

The parent object used to scope the current object.

[`objectRestorationClass`](/documentation/UIKit/UIStateRestoring/objectRestorationClass)

The class responsible for creating this object when restoring the app’s state.

### Encoding and decoding the object

[`-  encodeRestorableStateWithCoder:`](/documentation/UIKit/UIStateRestoring/encodeRestorableState(with:))

Encodes state-related information for the object.

[`-  decodeRestorableStateWithCoder:`](/documentation/UIKit/UIStateRestoring/decodeRestorableState(with:))

Decodes and restores state-related information for the object.

[`-  applicationFinishedRestoringState`](/documentation/UIKit/UIStateRestoring/applicationFinishedRestoringState())

Called after all objects have had a chance to decode their state.

### Constants

[State restoration keys](/documentation/UIKit/state-restoration-keys)

Keys that are available in restoration archives.

## Relationships

### Conforming Types

[`UIAlertController`](/documentation/UIKit/UIAlertController)

[`UIVideoEditorController`](/documentation/UIKit/UIVideoEditorController)

[`UICollectionViewController`](/documentation/UIKit/UICollectionViewController)

[`UINavigationController`](/documentation/UIKit/UINavigationController)

[`UIDocumentPickerViewController`](/documentation/UIKit/UIDocumentPickerViewController)

[`UIDocumentMenuViewController`](/documentation/UIKit/UIDocumentMenuViewController)

[`UIColorPickerViewController`](/documentation/UIKit/UIColorPickerViewController)

[`UIDocumentBrowserViewController`](/documentation/UIKit/UIDocumentBrowserViewController)

[`UISplitViewController`](/documentation/UIKit/UISplitViewController)

[`UICloudSharingController`](/documentation/UIKit/UICloudSharingController)

[`UITabBarController`](/documentation/UIKit/UITabBarController)

[`UIDocumentPickerExtensionViewController`](/documentation/UIKit/UIDocumentPickerExtensionViewController)

[`UIImagePickerController`](/documentation/UIKit/UIImagePickerController)

[`UIReferenceLibraryViewController`](/documentation/UIKit/UIReferenceLibraryViewController)

[`UIDocumentViewController`](/documentation/UIKit/UIDocumentViewController)

[`UIViewController`](/documentation/UIKit/UIViewController)

[`UIPageViewController`](/documentation/UIKit/UIPageViewController)

[`UIFontPickerViewController`](/documentation/UIKit/UIFontPickerViewController)

[`UISearchContainerViewController`](/documentation/UIKit/UISearchContainerViewController)

[`UITextFormattingViewController`](/documentation/UIKit/UITextFormattingViewController)

[`UISearchController`](/documentation/UIKit/UISearchController)

[`UITableViewController`](/documentation/UIKit/UITableViewController)

[`UIInputViewController`](/documentation/UIKit/UIInputViewController)

[`UIActivityViewController`](/documentation/UIKit/UIActivityViewController)

### Inherits From

[`NSObjectProtocol`](/documentation/ObjectiveC/NSObjectProtocol)

---

Copyright &copy; 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)