<!--
{
  "availability" : [
    "iOS: 15.0.0 -",
    "iPadOS: 15.0.0 -",
    "macCatalyst: 15.0.0 -",
    "visionOS: 1.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "UIKit",
  "identifier" : "/documentation/UIKit/UIWindowScene/ActivationConfiguration",
  "metadataVersion" : "0.1.0",
  "role" : "Class",
  "symbol" : {
    "kind" : "Class",
    "modules" : [
      "UIKit"
    ],
    "preciseIdentifier" : "c:objc(cs)UIWindowSceneActivationConfiguration"
  },
  "title" : "UIWindowScene.ActivationConfiguration"
}
-->

# UIWindowScene.ActivationConfiguration

An object that provides configuration options for a window scene request.

```
class ActivationConfiguration
```

## Overview

Use a [`UIWindowScene.ActivationConfiguration`](/documentation/UIKit/UIWindowScene/ActivationConfiguration) object to request a new window scene from the system. An activation configuration requires a <doc://com.apple.documentation/documentation/Foundation/NSUserActivity> object that represents the scene’s content. You can specify a preferred presentation style for the new scene by including an optional [`UIWindowScene.ActivationRequestOptions`](/documentation/UIKit/UIWindowScene/ActivationRequestOptions) object. The system automatically animates the transition to the new scene, but you can customize the transition by providing an optional targeted preview.

To request scene activation from a view interaction, use an instance of this class with [`UIWindowScene.ActivationInteraction`](/documentation/UIKit/UIWindowScene/ActivationInteraction). To request scene activation from a context menu, use an instance of this class with [`UIWindowScene.ActivationAction`](/documentation/UIKit/UIWindowScene/ActivationAction).

## Topics

### Creating an activation configuration

[`init(userActivity:options:preview:)`](/documentation/UIKit/UIWindowScene/ActivationConfiguration/init(userActivity:options:preview:))

Creates an activation configuration.

[`initWithUserActivity:`](/documentation/UIKit/UIWindowSceneActivationConfiguration/initWithUserActivity:)

Creates an activation configuration.

### Getting information about the activation configuration

[`userActivity`](/documentation/UIKit/UIWindowScene/ActivationConfiguration/userActivity)

The user activity used to request a scene.

[`options`](/documentation/UIKit/UIWindowScene/ActivationConfiguration/options)

Options for customizing the scene request.

[`UIWindowScene.ActivationRequestOptions`](/documentation/UIKit/UIWindowScene/ActivationRequestOptions)

An object that contains information you want the system to use when activating a new window scene.

[`preview`](/documentation/UIKit/UIWindowScene/ActivationConfiguration/preview)

An optional targeted preview that the system uses to animate the transition to the new scene.


---

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)